@mavogel/awscdk-rootmail 0.0.328 → 0.0.330
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/settings.local.json +6 -2
- package/.jsii +4837 -117
- package/API.md +9 -3
- package/lib/rootmail.d.ts +2 -0
- package/lib/rootmail.js +2 -2
- package/lib/ses-receipt-ruleset-activation.d.ts +1 -1
- package/lib/ses-receipt-ruleset-activation.js +1 -1
- package/lib/ses-receive.d.ts +5 -1
- package/lib/ses-receive.js +2 -2
- package/node_modules/@aws-sdk/client-cloudwatch-logs/README.md +26 -46
- package/node_modules/@aws-sdk/client-cloudwatch-logs/package.json +37 -37
- package/node_modules/@aws-sdk/client-route-53/README.md +26 -46
- package/node_modules/@aws-sdk/client-route-53/package.json +36 -36
- package/node_modules/@aws-sdk/client-s3/README.md +26 -46
- package/node_modules/@aws-sdk/client-s3/dist-cjs/index.js +5 -0
- package/node_modules/@aws-sdk/client-s3/dist-cjs/schemas/schemas_0.js +6 -4
- package/node_modules/@aws-sdk/client-s3/dist-es/models/enums.js +4 -0
- package/node_modules/@aws-sdk/client-s3/dist-es/schemas/schemas_0.js +6 -4
- package/node_modules/@aws-sdk/client-s3/dist-types/commands/CopyObjectCommand.d.ts +5 -4
- package/node_modules/@aws-sdk/client-s3/dist-types/commands/CreateBucketCommand.d.ts +9 -0
- package/node_modules/@aws-sdk/client-s3/dist-types/commands/DeleteBucketTaggingCommand.d.ts +0 -1
- package/node_modules/@aws-sdk/client-s3/dist-types/commands/GetBucketTaggingCommand.d.ts +0 -1
- package/node_modules/@aws-sdk/client-s3/dist-types/commands/HeadBucketCommand.d.ts +5 -4
- package/node_modules/@aws-sdk/client-s3/dist-types/commands/UploadPartCopyCommand.d.ts +5 -4
- package/node_modules/@aws-sdk/client-s3/dist-types/models/enums.d.ts +12 -0
- package/node_modules/@aws-sdk/client-s3/dist-types/models/models_0.d.ts +24 -2
- package/node_modules/@aws-sdk/client-s3/dist-types/ts3.4/models/enums.d.ts +6 -0
- package/node_modules/@aws-sdk/client-s3/dist-types/ts3.4/models/models_0.d.ts +2 -0
- package/node_modules/@aws-sdk/client-s3/package.json +50 -50
- package/node_modules/@aws-sdk/client-ses/README.md +26 -46
- package/node_modules/@aws-sdk/client-ses/package.json +34 -34
- package/node_modules/@aws-sdk/client-ssm/README.md +26 -46
- package/node_modules/@aws-sdk/client-ssm/package.json +34 -34
- package/node_modules/@aws-sdk/core/package.json +11 -11
- package/node_modules/@aws-sdk/crc64-nvme/package.json +2 -2
- package/node_modules/@aws-sdk/credential-provider-env/package.json +5 -5
- package/node_modules/@aws-sdk/credential-provider-http/package.json +10 -10
- package/node_modules/@aws-sdk/credential-provider-ini/package.json +14 -14
- package/node_modules/@aws-sdk/credential-provider-login/package.json +8 -8
- package/node_modules/@aws-sdk/credential-provider-node/package.json +12 -12
- package/node_modules/@aws-sdk/credential-provider-process/package.json +6 -6
- package/node_modules/@aws-sdk/credential-provider-sso/package.json +8 -8
- package/node_modules/@aws-sdk/credential-provider-web-identity/package.json +7 -7
- package/node_modules/@aws-sdk/middleware-bucket-endpoint/package.json +5 -5
- package/node_modules/@aws-sdk/middleware-expect-continue/package.json +4 -4
- package/node_modules/@aws-sdk/middleware-flexible-checksums/dist-cjs/index.js +19 -7
- package/node_modules/@aws-sdk/middleware-flexible-checksums/dist-es/flexibleChecksumsResponseMiddleware.js +10 -2
- package/node_modules/@aws-sdk/middleware-flexible-checksums/dist-es/getChecksumAlgorithmListForResponse.js +10 -6
- package/node_modules/@aws-sdk/middleware-flexible-checksums/package.json +10 -10
- package/node_modules/@aws-sdk/middleware-host-header/package.json +4 -4
- package/node_modules/@aws-sdk/middleware-location-constraint/package.json +3 -3
- package/node_modules/@aws-sdk/middleware-logger/package.json +3 -3
- package/node_modules/@aws-sdk/middleware-recursion-detection/package.json +4 -4
- package/node_modules/@aws-sdk/middleware-sdk-route53/package.json +3 -3
- package/node_modules/@aws-sdk/middleware-sdk-s3/package.json +11 -11
- package/node_modules/@aws-sdk/middleware-ssec/package.json +3 -3
- package/node_modules/@aws-sdk/middleware-user-agent/package.json +8 -8
- package/node_modules/@aws-sdk/nested-clients/package.json +32 -32
- package/node_modules/@aws-sdk/region-config-resolver/package.json +5 -5
- package/node_modules/@aws-sdk/signature-v4-multi-region/package.json +6 -6
- package/node_modules/@aws-sdk/token-providers/package.json +7 -7
- package/node_modules/@aws-sdk/types/package.json +2 -2
- package/node_modules/@aws-sdk/util-endpoints/package.json +5 -5
- package/node_modules/@aws-sdk/util-user-agent-browser/package.json +3 -3
- package/node_modules/@aws-sdk/util-user-agent-node/dist-cjs/index.js +75 -19
- package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getNodeModulesParentDirs.js +15 -0
- package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getSanitizedDevTypeScriptVersion.js +14 -0
- package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getTypeScriptUserAgentPair.js +53 -7
- package/node_modules/@aws-sdk/util-user-agent-node/dist-types/{getTypeScriptPackageJsonPaths.d.ts → getNodeModulesParentDirs.d.ts} +2 -2
- package/node_modules/@aws-sdk/util-user-agent-node/dist-types/getSanitizedDevTypeScriptVersion.d.ts +8 -0
- package/node_modules/@aws-sdk/util-user-agent-node/dist-types/ts3.4/getNodeModulesParentDirs.d.ts +1 -0
- package/node_modules/@aws-sdk/util-user-agent-node/dist-types/ts3.4/getSanitizedDevTypeScriptVersion.d.ts +3 -0
- package/node_modules/@aws-sdk/util-user-agent-node/package.json +6 -5
- package/node_modules/@aws-sdk/xml-builder/package.json +2 -2
- package/node_modules/@smithy/abort-controller/package.json +2 -2
- package/node_modules/@smithy/config-resolver/package.json +5 -5
- package/node_modules/@smithy/core/dist-cjs/index.js +1 -2
- package/node_modules/@smithy/core/dist-cjs/submodules/cbor/index.js +7 -1
- package/node_modules/@smithy/core/dist-cjs/submodules/endpoints/index.js +22 -0
- package/node_modules/@smithy/core/dist-cjs/submodules/protocols/index.js +11 -1
- package/node_modules/@smithy/core/dist-cjs/submodules/schema/index.js +41 -4
- package/node_modules/@smithy/core/dist-es/middleware-http-auth-scheme/getHttpAuthSchemePlugin.js +1 -2
- package/node_modules/@smithy/core/dist-es/submodules/cbor/parseCborBody.js +7 -1
- package/node_modules/@smithy/core/dist-es/submodules/endpoints/index.js +1 -0
- package/node_modules/@smithy/core/dist-es/submodules/endpoints/toEndpointV1.js +17 -0
- package/node_modules/@smithy/core/dist-es/submodules/protocols/HttpProtocol.js +10 -0
- package/node_modules/@smithy/core/dist-es/submodules/protocols/RpcProtocol.js +1 -1
- package/node_modules/@smithy/core/dist-es/submodules/schema/middleware/schemaSerializationMiddleware.js +3 -2
- package/node_modules/@smithy/core/dist-es/submodules/schema/schemas/NormalizedSchema.js +30 -1
- package/node_modules/@smithy/core/dist-es/submodules/schema/schemas/translateTraits.js +5 -1
- package/node_modules/@smithy/core/dist-types/submodules/endpoints/index.d.ts +1 -0
- package/node_modules/@smithy/core/dist-types/submodules/endpoints/toEndpointV1.d.ts +6 -0
- package/node_modules/@smithy/core/dist-types/submodules/schema/schemas/NormalizedSchema.d.ts +11 -0
- package/node_modules/@smithy/core/dist-types/submodules/schema/schemas/translateTraits.d.ts +6 -0
- package/node_modules/@smithy/core/dist-types/ts3.4/submodules/endpoints/index.d.ts +1 -0
- package/node_modules/@smithy/core/dist-types/ts3.4/submodules/endpoints/toEndpointV1.d.ts +6 -0
- package/node_modules/@smithy/core/dist-types/ts3.4/submodules/schema/schemas/NormalizedSchema.d.ts +11 -0
- package/node_modules/@smithy/core/dist-types/ts3.4/submodules/schema/schemas/translateTraits.d.ts +6 -0
- package/node_modules/@smithy/core/endpoints.d.ts +7 -0
- package/node_modules/@smithy/core/endpoints.js +6 -0
- package/node_modules/@smithy/core/package.json +16 -7
- package/node_modules/@smithy/credential-provider-imds/package.json +5 -5
- package/node_modules/@smithy/eventstream-codec/package.json +2 -2
- package/node_modules/@smithy/eventstream-serde-browser/package.json +3 -3
- package/node_modules/@smithy/eventstream-serde-config-resolver/package.json +2 -2
- package/node_modules/@smithy/eventstream-serde-node/package.json +3 -3
- package/node_modules/@smithy/eventstream-serde-universal/package.json +3 -3
- package/node_modules/@smithy/fetch-http-handler/dist-cjs/index.js +4 -1
- package/node_modules/@smithy/fetch-http-handler/dist-es/fetch-http-handler.js +4 -1
- package/node_modules/@smithy/fetch-http-handler/package.json +5 -5
- package/node_modules/@smithy/hash-blob-browser/package.json +2 -2
- package/node_modules/@smithy/hash-node/package.json +2 -2
- package/node_modules/@smithy/hash-stream-node/package.json +2 -2
- package/node_modules/@smithy/invalid-dependency/package.json +2 -2
- package/node_modules/@smithy/md5-js/package.json +2 -2
- package/node_modules/@smithy/middleware-content-length/package.json +3 -3
- package/node_modules/@smithy/middleware-endpoint/dist-cjs/index.js +17 -1
- package/node_modules/@smithy/middleware-endpoint/dist-es/adaptors/getEndpointFromInstructions.js +9 -0
- package/node_modules/@smithy/middleware-endpoint/dist-es/adaptors/toEndpointV1.js +8 -1
- package/node_modules/@smithy/middleware-endpoint/dist-types/adaptors/toEndpointV1.d.ts +1 -0
- package/node_modules/@smithy/middleware-endpoint/dist-types/ts3.4/adaptors/toEndpointV1.d.ts +1 -0
- package/node_modules/@smithy/middleware-endpoint/package.json +8 -8
- package/node_modules/@smithy/middleware-retry/dist-cjs/index.js +9 -12
- package/node_modules/@smithy/middleware-retry/dist-es/configurations.js +9 -12
- package/node_modules/@smithy/middleware-retry/package.json +8 -8
- package/node_modules/@smithy/middleware-serde/dist-cjs/index.js +3 -2
- package/node_modules/@smithy/middleware-serde/dist-es/serializerMiddleware.js +3 -2
- package/node_modules/@smithy/middleware-serde/package.json +4 -3
- package/node_modules/@smithy/middleware-stack/package.json +2 -2
- package/node_modules/@smithy/node-config-provider/package.json +4 -4
- package/node_modules/@smithy/node-http-handler/dist-cjs/index.js +48 -38
- package/node_modules/@smithy/node-http-handler/dist-es/build-abort-error.js +4 -1
- package/node_modules/@smithy/node-http-handler/dist-es/node-http-handler.js +38 -31
- package/node_modules/@smithy/node-http-handler/dist-es/node-http2-connection-manager.js +1 -1
- package/node_modules/@smithy/node-http-handler/dist-es/node-http2-handler.js +1 -1
- package/node_modules/@smithy/node-http-handler/dist-es/readable.mock.js +1 -1
- package/node_modules/@smithy/node-http-handler/dist-es/server.mock.js +6 -6
- package/node_modules/@smithy/node-http-handler/dist-es/stream-collector/collector.js +1 -1
- package/node_modules/@smithy/node-http-handler/dist-es/stream-collector/readable.mock.js +1 -1
- package/node_modules/@smithy/node-http-handler/dist-es/write-request-body.js +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/build-abort-error.d.ts +4 -3
- package/node_modules/@smithy/node-http-handler/dist-types/get-transformed-headers.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/node-http-handler.d.ts +4 -4
- package/node_modules/@smithy/node-http-handler/dist-types/node-http2-connection-manager.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/node-http2-connection-pool.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/readable.mock.d.ts +2 -2
- package/node_modules/@smithy/node-http-handler/dist-types/server.mock.d.ts +3 -3
- package/node_modules/@smithy/node-http-handler/dist-types/set-connection-timeout.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/set-request-timeout.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/set-socket-keep-alive.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/set-socket-timeout.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/stream-collector/collector.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/stream-collector/readable.mock.d.ts +2 -2
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/build-abort-error.d.ts +4 -3
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/get-transformed-headers.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/node-http-handler.d.ts +4 -4
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/node-http2-connection-manager.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/node-http2-connection-pool.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/readable.mock.d.ts +2 -2
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/server.mock.d.ts +3 -3
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-connection-timeout.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-request-timeout.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-socket-keep-alive.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-socket-timeout.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/stream-collector/collector.d.ts +1 -1
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/stream-collector/readable.mock.d.ts +2 -2
- package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/write-request-body.d.ts +2 -2
- package/node_modules/@smithy/node-http-handler/dist-types/write-request-body.d.ts +2 -2
- package/node_modules/@smithy/node-http-handler/package.json +5 -5
- package/node_modules/@smithy/property-provider/package.json +2 -2
- package/node_modules/@smithy/protocol-http/package.json +2 -2
- package/node_modules/@smithy/querystring-builder/package.json +2 -2
- package/node_modules/@smithy/querystring-parser/package.json +2 -2
- package/node_modules/@smithy/service-error-classification/package.json +2 -2
- package/node_modules/@smithy/shared-ini-file-loader/package.json +2 -2
- package/node_modules/@smithy/signature-v4/package.json +4 -4
- package/node_modules/@smithy/smithy-client/package.json +7 -7
- package/node_modules/@smithy/types/dist-types/http.d.ts +1 -0
- package/node_modules/@smithy/types/dist-types/ts3.4/http.d.ts +1 -0
- package/node_modules/@smithy/types/package.json +1 -1
- package/node_modules/@smithy/url-parser/package.json +3 -3
- package/node_modules/@smithy/util-defaults-mode-browser/package.json +4 -4
- package/node_modules/@smithy/util-defaults-mode-node/package.json +7 -7
- package/node_modules/@smithy/util-endpoints/package.json +3 -3
- package/node_modules/@smithy/util-middleware/package.json +2 -2
- package/node_modules/@smithy/util-retry/package.json +3 -3
- package/node_modules/@smithy/util-stream/package.json +4 -4
- package/node_modules/@smithy/util-waiter/dist-cjs/index.js +1 -1
- package/node_modules/@smithy/util-waiter/dist-es/poller.js +1 -1
- package/node_modules/@smithy/util-waiter/package.json +3 -3
- package/package.json +17 -17
- package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getTypeScriptPackageJsonPaths.js +0 -17
- package/node_modules/@aws-sdk/util-user-agent-node/dist-types/ts3.4/getTypeScriptPackageJsonPaths.d.ts +0 -3
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { StreamingBlobTypes } from "@smithy/types";
|
|
2
|
-
import { AnalyticsS3ExportFileFormat, ArchiveStatus, BucketAbacStatus, BucketAccelerateStatus, BucketCannedACL, BucketLocationConstraint, BucketLogsPermission, BucketType, BucketVersioningStatus, ChecksumAlgorithm, ChecksumMode, ChecksumType, DataRedundancy, DeleteMarkerReplicationStatus, EncodingType, EncryptionType, Event, ExistingObjectReplicationStatus, ExpirationState, ExpirationStatus, FileHeaderInfo, FilterRuleName, IntelligentTieringAccessTier, IntelligentTieringStatus, InventoryConfigurationState, InventoryFormat, InventoryFrequency, InventoryIncludedObjectVersions, InventoryOptionalField, JSONType, LocationType, MetadataDirective, MetricsStatus, MFADelete, MFADeleteStatus, ObjectAttributes, ObjectCannedACL, ObjectLockEnabled, ObjectLockLegalHoldStatus, ObjectLockMode, ObjectLockRetentionMode, ObjectOwnership, ObjectStorageClass, ObjectVersionStorageClass, OptionalObjectAttributes, OwnerOverride, PartitionDateSource, Payer, Permission, Protocol, ReplicaModificationsStatus, ReplicationRuleStatus, ReplicationStatus, ReplicationTimeStatus, RequestCharged, RequestPayer, S3TablesBucketType, ServerSideEncryption, SessionMode, SseKmsEncryptedObjectsStatus, StorageClass, StorageClassAnalysisSchemaVersion, TableSseAlgorithm, TaggingDirective, Tier, TransitionDefaultMinimumObjectSize, TransitionStorageClass, Type } from "./enums";
|
|
2
|
+
import { AnalyticsS3ExportFileFormat, ArchiveStatus, BucketAbacStatus, BucketAccelerateStatus, BucketCannedACL, BucketLocationConstraint, BucketLogsPermission, BucketNamespace, BucketType, BucketVersioningStatus, ChecksumAlgorithm, ChecksumMode, ChecksumType, DataRedundancy, DeleteMarkerReplicationStatus, EncodingType, EncryptionType, Event, ExistingObjectReplicationStatus, ExpirationState, ExpirationStatus, FileHeaderInfo, FilterRuleName, IntelligentTieringAccessTier, IntelligentTieringStatus, InventoryConfigurationState, InventoryFormat, InventoryFrequency, InventoryIncludedObjectVersions, InventoryOptionalField, JSONType, LocationType, MetadataDirective, MetricsStatus, MFADelete, MFADeleteStatus, ObjectAttributes, ObjectCannedACL, ObjectLockEnabled, ObjectLockLegalHoldStatus, ObjectLockMode, ObjectLockRetentionMode, ObjectOwnership, ObjectStorageClass, ObjectVersionStorageClass, OptionalObjectAttributes, OwnerOverride, PartitionDateSource, Payer, Permission, Protocol, ReplicaModificationsStatus, ReplicationRuleStatus, ReplicationStatus, ReplicationTimeStatus, RequestCharged, RequestPayer, S3TablesBucketType, ServerSideEncryption, SessionMode, SseKmsEncryptedObjectsStatus, StorageClass, StorageClassAnalysisSchemaVersion, TableSseAlgorithm, TaggingDirective, Tier, TransitionDefaultMinimumObjectSize, TransitionStorageClass, Type } from "./enums";
|
|
3
3
|
/**
|
|
4
4
|
* <p>The ABAC status of the general purpose bucket. When ABAC is enabled for the general purpose bucket, you can use tags to manage access to the general purpose buckets as well as for cost tracking purposes. When ABAC is disabled for the general purpose buckets, you can only use tags for cost tracking purposes. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html">Using tags with S3 general purpose buckets</a>. </p>
|
|
5
5
|
* @public
|
|
@@ -1718,6 +1718,25 @@ export interface CreateBucketRequest {
|
|
|
1718
1718
|
* @public
|
|
1719
1719
|
*/
|
|
1720
1720
|
ObjectOwnership?: ObjectOwnership | undefined;
|
|
1721
|
+
/**
|
|
1722
|
+
* <p>Specifies the namespace where you want to create your general purpose bucket. When you create a
|
|
1723
|
+
* general purpose bucket, you can choose to create a bucket in the shared global namespace or you can choose to
|
|
1724
|
+
* create a bucket in your account regional namespace. Your account regional namespace is a subdivision of
|
|
1725
|
+
* the global namespace that only your account can create buckets in. For more information on bucket
|
|
1726
|
+
* namespaces, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html">Namespaces for general purpose buckets</a>.</p>
|
|
1727
|
+
* <p>General purpose buckets in your account regional namespace must follow a specific naming convention. These
|
|
1728
|
+
* buckets consist of a bucket name prefix that you create, and a suffix that contains your 12-digit Amazon Web Services
|
|
1729
|
+
* Account ID, the Amazon Web Services Region code, and ends with <code>-an</code>. Bucket names must follow the format
|
|
1730
|
+
* <code>bucket-name-prefix-accountId-region-an</code> (for example,
|
|
1731
|
+
* <code>amzn-s3-demo-bucket-111122223333-us-west-2-an</code>). For information about bucket naming
|
|
1732
|
+
* restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html#account-regional-naming-rules">Account regional namespace naming rules</a>
|
|
1733
|
+
* in the <i>Amazon S3 User Guide</i>.</p>
|
|
1734
|
+
* <note>
|
|
1735
|
+
* <p>This functionality is not supported for directory buckets.</p>
|
|
1736
|
+
* </note>
|
|
1737
|
+
* @public
|
|
1738
|
+
*/
|
|
1739
|
+
BucketNamespace?: BucketNamespace | undefined;
|
|
1721
1740
|
}
|
|
1722
1741
|
/**
|
|
1723
1742
|
* <p>
|
|
@@ -2742,7 +2761,10 @@ export interface CreateSessionOutput {
|
|
|
2742
2761
|
export interface CreateSessionRequest {
|
|
2743
2762
|
/**
|
|
2744
2763
|
* <p>Specifies the mode of the session that will be created, either <code>ReadWrite</code> or
|
|
2745
|
-
* <code>ReadOnly</code>.
|
|
2764
|
+
* <code>ReadOnly</code>. If no session mode is specified, the default behavior attempts to create
|
|
2765
|
+
* a session with the maximum allowable privilege. It will first attempt to create a
|
|
2766
|
+
* <code>ReadWrite</code> session, and if that is not allowed by permissions, it will attempt to create a
|
|
2767
|
+
* <code>ReadOnly</code> session. If neither session type is allowed, the request will return an Access Denied error. A
|
|
2746
2768
|
* <code>ReadWrite</code> session is capable of executing all the Zonal endpoint API operations on a directory bucket. A
|
|
2747
2769
|
* <code>ReadOnly</code> session is constrained to execute the following Zonal endpoint API operations:
|
|
2748
2770
|
* <code>GetObject</code>, <code>HeadObject</code>, <code>ListObjectsV2</code>,
|
|
@@ -118,6 +118,12 @@ export declare const BucketCannedACL: {
|
|
|
118
118
|
};
|
|
119
119
|
export type BucketCannedACL =
|
|
120
120
|
(typeof BucketCannedACL)[keyof typeof BucketCannedACL];
|
|
121
|
+
export declare const BucketNamespace: {
|
|
122
|
+
readonly ACCOUNT_REGIONAL: "account-regional";
|
|
123
|
+
readonly GLOBAL: "global";
|
|
124
|
+
};
|
|
125
|
+
export type BucketNamespace =
|
|
126
|
+
(typeof BucketNamespace)[keyof typeof BucketNamespace];
|
|
121
127
|
export declare const DataRedundancy: {
|
|
122
128
|
readonly SingleAvailabilityZone: "SingleAvailabilityZone";
|
|
123
129
|
readonly SingleLocalZone: "SingleLocalZone";
|
|
@@ -7,6 +7,7 @@ import {
|
|
|
7
7
|
BucketCannedACL,
|
|
8
8
|
BucketLocationConstraint,
|
|
9
9
|
BucketLogsPermission,
|
|
10
|
+
BucketNamespace,
|
|
10
11
|
BucketType,
|
|
11
12
|
BucketVersioningStatus,
|
|
12
13
|
ChecksumAlgorithm,
|
|
@@ -262,6 +263,7 @@ export interface CreateBucketRequest {
|
|
|
262
263
|
GrantWriteACP?: string | undefined;
|
|
263
264
|
ObjectLockEnabledForBucket?: boolean | undefined;
|
|
264
265
|
ObjectOwnership?: ObjectOwnership | undefined;
|
|
266
|
+
BucketNamespace?: BucketNamespace | undefined;
|
|
265
267
|
}
|
|
266
268
|
export interface MetadataTableEncryptionConfiguration {
|
|
267
269
|
SseAlgorithm: TableSseAlgorithm | undefined;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aws-sdk/client-s3",
|
|
3
3
|
"description": "AWS SDK for JavaScript S3 Client for Node.js, Browser and React Native",
|
|
4
|
-
"version": "3.
|
|
4
|
+
"version": "3.1010.0",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"build": "concurrently 'yarn:build:types' 'yarn:build:es' && yarn build:cjs",
|
|
7
7
|
"build:cjs": "node ../../scripts/compilation/inline client-s3",
|
|
@@ -30,62 +30,62 @@
|
|
|
30
30
|
"@aws-crypto/sha1-browser": "5.2.0",
|
|
31
31
|
"@aws-crypto/sha256-browser": "5.2.0",
|
|
32
32
|
"@aws-crypto/sha256-js": "5.2.0",
|
|
33
|
-
"@aws-sdk/core": "^3.973.
|
|
34
|
-
"@aws-sdk/credential-provider-node": "^3.972.
|
|
35
|
-
"@aws-sdk/middleware-bucket-endpoint": "^3.972.
|
|
36
|
-
"@aws-sdk/middleware-expect-continue": "^3.972.
|
|
37
|
-
"@aws-sdk/middleware-flexible-checksums": "^3.
|
|
38
|
-
"@aws-sdk/middleware-host-header": "^3.972.
|
|
39
|
-
"@aws-sdk/middleware-location-constraint": "^3.972.
|
|
40
|
-
"@aws-sdk/middleware-logger": "^3.972.
|
|
41
|
-
"@aws-sdk/middleware-recursion-detection": "^3.972.
|
|
42
|
-
"@aws-sdk/middleware-sdk-s3": "^3.972.
|
|
43
|
-
"@aws-sdk/middleware-ssec": "^3.972.
|
|
44
|
-
"@aws-sdk/middleware-user-agent": "^3.972.
|
|
45
|
-
"@aws-sdk/region-config-resolver": "^3.972.
|
|
46
|
-
"@aws-sdk/signature-v4-multi-region": "^3.996.
|
|
47
|
-
"@aws-sdk/types": "^3.973.
|
|
48
|
-
"@aws-sdk/util-endpoints": "^3.996.
|
|
49
|
-
"@aws-sdk/util-user-agent-browser": "^3.972.
|
|
50
|
-
"@aws-sdk/util-user-agent-node": "^3.973.
|
|
51
|
-
"@smithy/config-resolver": "^4.4.
|
|
52
|
-
"@smithy/core": "^3.23.
|
|
53
|
-
"@smithy/eventstream-serde-browser": "^4.2.
|
|
54
|
-
"@smithy/eventstream-serde-config-resolver": "^4.3.
|
|
55
|
-
"@smithy/eventstream-serde-node": "^4.2.
|
|
56
|
-
"@smithy/fetch-http-handler": "^5.3.
|
|
57
|
-
"@smithy/hash-blob-browser": "^4.2.
|
|
58
|
-
"@smithy/hash-node": "^4.2.
|
|
59
|
-
"@smithy/hash-stream-node": "^4.2.
|
|
60
|
-
"@smithy/invalid-dependency": "^4.2.
|
|
61
|
-
"@smithy/md5-js": "^4.2.
|
|
62
|
-
"@smithy/middleware-content-length": "^4.2.
|
|
63
|
-
"@smithy/middleware-endpoint": "^4.4.
|
|
64
|
-
"@smithy/middleware-retry": "^4.4.
|
|
65
|
-
"@smithy/middleware-serde": "^4.2.
|
|
66
|
-
"@smithy/middleware-stack": "^4.2.
|
|
67
|
-
"@smithy/node-config-provider": "^4.3.
|
|
68
|
-
"@smithy/node-http-handler": "^4.4.
|
|
69
|
-
"@smithy/protocol-http": "^5.3.
|
|
70
|
-
"@smithy/smithy-client": "^4.12.
|
|
71
|
-
"@smithy/types": "^4.13.
|
|
72
|
-
"@smithy/url-parser": "^4.2.
|
|
33
|
+
"@aws-sdk/core": "^3.973.20",
|
|
34
|
+
"@aws-sdk/credential-provider-node": "^3.972.21",
|
|
35
|
+
"@aws-sdk/middleware-bucket-endpoint": "^3.972.8",
|
|
36
|
+
"@aws-sdk/middleware-expect-continue": "^3.972.8",
|
|
37
|
+
"@aws-sdk/middleware-flexible-checksums": "^3.974.0",
|
|
38
|
+
"@aws-sdk/middleware-host-header": "^3.972.8",
|
|
39
|
+
"@aws-sdk/middleware-location-constraint": "^3.972.8",
|
|
40
|
+
"@aws-sdk/middleware-logger": "^3.972.8",
|
|
41
|
+
"@aws-sdk/middleware-recursion-detection": "^3.972.8",
|
|
42
|
+
"@aws-sdk/middleware-sdk-s3": "^3.972.20",
|
|
43
|
+
"@aws-sdk/middleware-ssec": "^3.972.8",
|
|
44
|
+
"@aws-sdk/middleware-user-agent": "^3.972.21",
|
|
45
|
+
"@aws-sdk/region-config-resolver": "^3.972.8",
|
|
46
|
+
"@aws-sdk/signature-v4-multi-region": "^3.996.8",
|
|
47
|
+
"@aws-sdk/types": "^3.973.6",
|
|
48
|
+
"@aws-sdk/util-endpoints": "^3.996.5",
|
|
49
|
+
"@aws-sdk/util-user-agent-browser": "^3.972.8",
|
|
50
|
+
"@aws-sdk/util-user-agent-node": "^3.973.7",
|
|
51
|
+
"@smithy/config-resolver": "^4.4.11",
|
|
52
|
+
"@smithy/core": "^3.23.11",
|
|
53
|
+
"@smithy/eventstream-serde-browser": "^4.2.12",
|
|
54
|
+
"@smithy/eventstream-serde-config-resolver": "^4.3.12",
|
|
55
|
+
"@smithy/eventstream-serde-node": "^4.2.12",
|
|
56
|
+
"@smithy/fetch-http-handler": "^5.3.15",
|
|
57
|
+
"@smithy/hash-blob-browser": "^4.2.13",
|
|
58
|
+
"@smithy/hash-node": "^4.2.12",
|
|
59
|
+
"@smithy/hash-stream-node": "^4.2.12",
|
|
60
|
+
"@smithy/invalid-dependency": "^4.2.12",
|
|
61
|
+
"@smithy/md5-js": "^4.2.12",
|
|
62
|
+
"@smithy/middleware-content-length": "^4.2.12",
|
|
63
|
+
"@smithy/middleware-endpoint": "^4.4.25",
|
|
64
|
+
"@smithy/middleware-retry": "^4.4.42",
|
|
65
|
+
"@smithy/middleware-serde": "^4.2.14",
|
|
66
|
+
"@smithy/middleware-stack": "^4.2.12",
|
|
67
|
+
"@smithy/node-config-provider": "^4.3.12",
|
|
68
|
+
"@smithy/node-http-handler": "^4.4.16",
|
|
69
|
+
"@smithy/protocol-http": "^5.3.12",
|
|
70
|
+
"@smithy/smithy-client": "^4.12.5",
|
|
71
|
+
"@smithy/types": "^4.13.1",
|
|
72
|
+
"@smithy/url-parser": "^4.2.12",
|
|
73
73
|
"@smithy/util-base64": "^4.3.2",
|
|
74
74
|
"@smithy/util-body-length-browser": "^4.2.2",
|
|
75
75
|
"@smithy/util-body-length-node": "^4.2.3",
|
|
76
|
-
"@smithy/util-defaults-mode-browser": "^4.3.
|
|
77
|
-
"@smithy/util-defaults-mode-node": "^4.2.
|
|
78
|
-
"@smithy/util-endpoints": "^3.3.
|
|
79
|
-
"@smithy/util-middleware": "^4.2.
|
|
80
|
-
"@smithy/util-retry": "^4.2.
|
|
81
|
-
"@smithy/util-stream": "^4.5.
|
|
76
|
+
"@smithy/util-defaults-mode-browser": "^4.3.41",
|
|
77
|
+
"@smithy/util-defaults-mode-node": "^4.2.44",
|
|
78
|
+
"@smithy/util-endpoints": "^3.3.3",
|
|
79
|
+
"@smithy/util-middleware": "^4.2.12",
|
|
80
|
+
"@smithy/util-retry": "^4.2.12",
|
|
81
|
+
"@smithy/util-stream": "^4.5.19",
|
|
82
82
|
"@smithy/util-utf8": "^4.2.2",
|
|
83
|
-
"@smithy/util-waiter": "^4.2.
|
|
83
|
+
"@smithy/util-waiter": "^4.2.13",
|
|
84
84
|
"tslib": "^2.6.2"
|
|
85
85
|
},
|
|
86
86
|
"devDependencies": {
|
|
87
|
-
"@aws-sdk/signature-v4-crt": "3.
|
|
88
|
-
"@smithy/snapshot-testing": "^
|
|
87
|
+
"@aws-sdk/signature-v4-crt": "3.1010.0",
|
|
88
|
+
"@smithy/snapshot-testing": "^2.0.2",
|
|
89
89
|
"@tsconfig/node20": "20.1.8",
|
|
90
90
|
"@types/node": "^20.14.8",
|
|
91
91
|
"concurrently": "7.0.0",
|
|
@@ -42,8 +42,9 @@ Parameters</a>
|
|
|
42
42
|
</ul>
|
|
43
43
|
|
|
44
44
|
## Installing
|
|
45
|
-
|
|
46
|
-
|
|
45
|
+
|
|
46
|
+
To install this package, use the CLI of your favorite package manager:
|
|
47
|
+
|
|
47
48
|
- `npm install @aws-sdk/client-ses`
|
|
48
49
|
- `yarn add @aws-sdk/client-ses`
|
|
49
50
|
- `pnpm add @aws-sdk/client-ses`
|
|
@@ -68,15 +69,15 @@ import { SESClient, ListIdentitiesCommand } from "@aws-sdk/client-ses";
|
|
|
68
69
|
|
|
69
70
|
### Usage
|
|
70
71
|
|
|
71
|
-
To send a request
|
|
72
|
+
To send a request:
|
|
72
73
|
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
-
|
|
74
|
+
- Instantiate a client with configuration (e.g. credentials, region).
|
|
75
|
+
- See [docs/CLIENTS](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/CLIENTS.md) for configuration details.
|
|
76
|
+
- See [@aws-sdk/config](https://github.com/aws/aws-sdk-js-v3/blob/main/packages/config/README.md) for additional options.
|
|
77
|
+
- Instantiate a command with input parameters.
|
|
78
|
+
- Call the `send` operation on the client, providing the command object as input.
|
|
77
79
|
|
|
78
80
|
```js
|
|
79
|
-
// a client can be shared by different commands.
|
|
80
81
|
const client = new SESClient({ region: "REGION" });
|
|
81
82
|
|
|
82
83
|
const params = { /** input parameters */ };
|
|
@@ -85,7 +86,7 @@ const command = new ListIdentitiesCommand(params);
|
|
|
85
86
|
|
|
86
87
|
#### Async/await
|
|
87
88
|
|
|
88
|
-
We recommend using [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
|
|
89
|
+
We recommend using the [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
|
|
89
90
|
operator to wait for the promise returned by send operation as follows:
|
|
90
91
|
|
|
91
92
|
```js
|
|
@@ -100,26 +101,9 @@ try {
|
|
|
100
101
|
}
|
|
101
102
|
```
|
|
102
103
|
|
|
103
|
-
Async-await is clean, concise, intuitive, easy to debug and has better error handling
|
|
104
|
-
as compared to using Promise chains or callbacks.
|
|
105
|
-
|
|
106
104
|
#### Promises
|
|
107
105
|
|
|
108
|
-
You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining)
|
|
109
|
-
to execute send operation.
|
|
110
|
-
|
|
111
|
-
```js
|
|
112
|
-
client.send(command).then(
|
|
113
|
-
(data) => {
|
|
114
|
-
// process data.
|
|
115
|
-
},
|
|
116
|
-
(error) => {
|
|
117
|
-
// error handling.
|
|
118
|
-
}
|
|
119
|
-
);
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
Promises can also be called using `.catch()` and `.finally()` as follows:
|
|
106
|
+
You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining).
|
|
123
107
|
|
|
124
108
|
```js
|
|
125
109
|
client
|
|
@@ -135,27 +119,21 @@ client
|
|
|
135
119
|
});
|
|
136
120
|
```
|
|
137
121
|
|
|
138
|
-
####
|
|
139
|
-
|
|
140
|
-
We do not recommend using callbacks because of [callback hell](http://callbackhell.com/),
|
|
141
|
-
but they are supported by the send operation.
|
|
122
|
+
#### Aggregated client
|
|
142
123
|
|
|
143
|
-
|
|
144
|
-
// callbacks.
|
|
145
|
-
client.send(command, (err, data) => {
|
|
146
|
-
// process err and data.
|
|
147
|
-
});
|
|
148
|
-
```
|
|
124
|
+
The aggregated client class is exported from the same package, but without the "Client" suffix.
|
|
149
125
|
|
|
150
|
-
|
|
126
|
+
`SES` extends `SESClient` and additionally supports all operations, waiters, and paginators as methods.
|
|
127
|
+
This style may be familiar to you from the AWS SDK for JavaScript v2.
|
|
151
128
|
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
129
|
+
If you are bundling the AWS SDK, we recommend using only the bare-bones client (`SESClient`).
|
|
130
|
+
More details are in the blog post on
|
|
131
|
+
[modular packages in AWS SDK for JavaScript](https://aws.amazon.com/blogs/developer/modular-packages-in-aws-sdk-for-javascript/).
|
|
155
132
|
|
|
156
133
|
```ts
|
|
157
|
-
import
|
|
158
|
-
|
|
134
|
+
import { SES } from "@aws-sdk/client-ses";
|
|
135
|
+
|
|
136
|
+
const client = new SES({ region: "REGION" });
|
|
159
137
|
|
|
160
138
|
// async/await.
|
|
161
139
|
try {
|
|
@@ -175,7 +153,7 @@ client
|
|
|
175
153
|
// error handling.
|
|
176
154
|
});
|
|
177
155
|
|
|
178
|
-
// callbacks.
|
|
156
|
+
// callbacks (not recommended).
|
|
179
157
|
client.listIdentities(params, (err, data) => {
|
|
180
158
|
// process err and data.
|
|
181
159
|
});
|
|
@@ -203,12 +181,14 @@ try {
|
|
|
203
181
|
}
|
|
204
182
|
```
|
|
205
183
|
|
|
184
|
+
See also [docs/ERROR_HANDLING](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/ERROR_HANDLING.md).
|
|
185
|
+
|
|
206
186
|
## Getting Help
|
|
207
187
|
|
|
208
188
|
Please use these community resources for getting help.
|
|
209
|
-
We use
|
|
189
|
+
We use GitHub issues for tracking bugs and feature requests, but have limited bandwidth to address them.
|
|
210
190
|
|
|
211
|
-
- Visit [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
|
|
191
|
+
- Visit the [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
|
|
212
192
|
or [API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/index.html).
|
|
213
193
|
- Check out the blog posts tagged with [`aws-sdk-js`](https://aws.amazon.com/blogs/developer/tag/aws-sdk-js/)
|
|
214
194
|
on AWS Developer Blog.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aws-sdk/client-ses",
|
|
3
3
|
"description": "AWS SDK for JavaScript Ses Client for Node.js, Browser and React Native",
|
|
4
|
-
"version": "3.
|
|
4
|
+
"version": "3.1010.0",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"build": "concurrently 'yarn:build:types' 'yarn:build:es' && yarn build:cjs",
|
|
7
7
|
"build:cjs": "node ../../scripts/compilation/inline client-ses",
|
|
@@ -23,43 +23,43 @@
|
|
|
23
23
|
"dependencies": {
|
|
24
24
|
"@aws-crypto/sha256-browser": "5.2.0",
|
|
25
25
|
"@aws-crypto/sha256-js": "5.2.0",
|
|
26
|
-
"@aws-sdk/core": "^3.973.
|
|
27
|
-
"@aws-sdk/credential-provider-node": "^3.972.
|
|
28
|
-
"@aws-sdk/middleware-host-header": "^3.972.
|
|
29
|
-
"@aws-sdk/middleware-logger": "^3.972.
|
|
30
|
-
"@aws-sdk/middleware-recursion-detection": "^3.972.
|
|
31
|
-
"@aws-sdk/middleware-user-agent": "^3.972.
|
|
32
|
-
"@aws-sdk/region-config-resolver": "^3.972.
|
|
33
|
-
"@aws-sdk/types": "^3.973.
|
|
34
|
-
"@aws-sdk/util-endpoints": "^3.996.
|
|
35
|
-
"@aws-sdk/util-user-agent-browser": "^3.972.
|
|
36
|
-
"@aws-sdk/util-user-agent-node": "^3.973.
|
|
37
|
-
"@smithy/config-resolver": "^4.4.
|
|
38
|
-
"@smithy/core": "^3.23.
|
|
39
|
-
"@smithy/fetch-http-handler": "^5.3.
|
|
40
|
-
"@smithy/hash-node": "^4.2.
|
|
41
|
-
"@smithy/invalid-dependency": "^4.2.
|
|
42
|
-
"@smithy/middleware-content-length": "^4.2.
|
|
43
|
-
"@smithy/middleware-endpoint": "^4.4.
|
|
44
|
-
"@smithy/middleware-retry": "^4.4.
|
|
45
|
-
"@smithy/middleware-serde": "^4.2.
|
|
46
|
-
"@smithy/middleware-stack": "^4.2.
|
|
47
|
-
"@smithy/node-config-provider": "^4.3.
|
|
48
|
-
"@smithy/node-http-handler": "^4.4.
|
|
49
|
-
"@smithy/protocol-http": "^5.3.
|
|
50
|
-
"@smithy/smithy-client": "^4.12.
|
|
51
|
-
"@smithy/types": "^4.13.
|
|
52
|
-
"@smithy/url-parser": "^4.2.
|
|
26
|
+
"@aws-sdk/core": "^3.973.20",
|
|
27
|
+
"@aws-sdk/credential-provider-node": "^3.972.21",
|
|
28
|
+
"@aws-sdk/middleware-host-header": "^3.972.8",
|
|
29
|
+
"@aws-sdk/middleware-logger": "^3.972.8",
|
|
30
|
+
"@aws-sdk/middleware-recursion-detection": "^3.972.8",
|
|
31
|
+
"@aws-sdk/middleware-user-agent": "^3.972.21",
|
|
32
|
+
"@aws-sdk/region-config-resolver": "^3.972.8",
|
|
33
|
+
"@aws-sdk/types": "^3.973.6",
|
|
34
|
+
"@aws-sdk/util-endpoints": "^3.996.5",
|
|
35
|
+
"@aws-sdk/util-user-agent-browser": "^3.972.8",
|
|
36
|
+
"@aws-sdk/util-user-agent-node": "^3.973.7",
|
|
37
|
+
"@smithy/config-resolver": "^4.4.11",
|
|
38
|
+
"@smithy/core": "^3.23.11",
|
|
39
|
+
"@smithy/fetch-http-handler": "^5.3.15",
|
|
40
|
+
"@smithy/hash-node": "^4.2.12",
|
|
41
|
+
"@smithy/invalid-dependency": "^4.2.12",
|
|
42
|
+
"@smithy/middleware-content-length": "^4.2.12",
|
|
43
|
+
"@smithy/middleware-endpoint": "^4.4.25",
|
|
44
|
+
"@smithy/middleware-retry": "^4.4.42",
|
|
45
|
+
"@smithy/middleware-serde": "^4.2.14",
|
|
46
|
+
"@smithy/middleware-stack": "^4.2.12",
|
|
47
|
+
"@smithy/node-config-provider": "^4.3.12",
|
|
48
|
+
"@smithy/node-http-handler": "^4.4.16",
|
|
49
|
+
"@smithy/protocol-http": "^5.3.12",
|
|
50
|
+
"@smithy/smithy-client": "^4.12.5",
|
|
51
|
+
"@smithy/types": "^4.13.1",
|
|
52
|
+
"@smithy/url-parser": "^4.2.12",
|
|
53
53
|
"@smithy/util-base64": "^4.3.2",
|
|
54
54
|
"@smithy/util-body-length-browser": "^4.2.2",
|
|
55
55
|
"@smithy/util-body-length-node": "^4.2.3",
|
|
56
|
-
"@smithy/util-defaults-mode-browser": "^4.3.
|
|
57
|
-
"@smithy/util-defaults-mode-node": "^4.2.
|
|
58
|
-
"@smithy/util-endpoints": "^3.3.
|
|
59
|
-
"@smithy/util-middleware": "^4.2.
|
|
60
|
-
"@smithy/util-retry": "^4.2.
|
|
56
|
+
"@smithy/util-defaults-mode-browser": "^4.3.41",
|
|
57
|
+
"@smithy/util-defaults-mode-node": "^4.2.44",
|
|
58
|
+
"@smithy/util-endpoints": "^3.3.3",
|
|
59
|
+
"@smithy/util-middleware": "^4.2.12",
|
|
60
|
+
"@smithy/util-retry": "^4.2.12",
|
|
61
61
|
"@smithy/util-utf8": "^4.2.2",
|
|
62
|
-
"@smithy/util-waiter": "^4.2.
|
|
62
|
+
"@smithy/util-waiter": "^4.2.13",
|
|
63
63
|
"tslib": "^2.6.2"
|
|
64
64
|
},
|
|
65
65
|
"devDependencies": {
|
|
@@ -46,8 +46,9 @@ Reference</a>
|
|
|
46
46
|
</ul>
|
|
47
47
|
|
|
48
48
|
## Installing
|
|
49
|
-
|
|
50
|
-
|
|
49
|
+
|
|
50
|
+
To install this package, use the CLI of your favorite package manager:
|
|
51
|
+
|
|
51
52
|
- `npm install @aws-sdk/client-ssm`
|
|
52
53
|
- `yarn add @aws-sdk/client-ssm`
|
|
53
54
|
- `pnpm add @aws-sdk/client-ssm`
|
|
@@ -72,15 +73,15 @@ import { SSMClient, ListNodesCommand } from "@aws-sdk/client-ssm";
|
|
|
72
73
|
|
|
73
74
|
### Usage
|
|
74
75
|
|
|
75
|
-
To send a request
|
|
76
|
+
To send a request:
|
|
76
77
|
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
78
|
+
- Instantiate a client with configuration (e.g. credentials, region).
|
|
79
|
+
- See [docs/CLIENTS](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/CLIENTS.md) for configuration details.
|
|
80
|
+
- See [@aws-sdk/config](https://github.com/aws/aws-sdk-js-v3/blob/main/packages/config/README.md) for additional options.
|
|
81
|
+
- Instantiate a command with input parameters.
|
|
82
|
+
- Call the `send` operation on the client, providing the command object as input.
|
|
81
83
|
|
|
82
84
|
```js
|
|
83
|
-
// a client can be shared by different commands.
|
|
84
85
|
const client = new SSMClient({ region: "REGION" });
|
|
85
86
|
|
|
86
87
|
const params = { /** input parameters */ };
|
|
@@ -89,7 +90,7 @@ const command = new ListNodesCommand(params);
|
|
|
89
90
|
|
|
90
91
|
#### Async/await
|
|
91
92
|
|
|
92
|
-
We recommend using [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
|
|
93
|
+
We recommend using the [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
|
|
93
94
|
operator to wait for the promise returned by send operation as follows:
|
|
94
95
|
|
|
95
96
|
```js
|
|
@@ -104,26 +105,9 @@ try {
|
|
|
104
105
|
}
|
|
105
106
|
```
|
|
106
107
|
|
|
107
|
-
Async-await is clean, concise, intuitive, easy to debug and has better error handling
|
|
108
|
-
as compared to using Promise chains or callbacks.
|
|
109
|
-
|
|
110
108
|
#### Promises
|
|
111
109
|
|
|
112
|
-
You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining)
|
|
113
|
-
to execute send operation.
|
|
114
|
-
|
|
115
|
-
```js
|
|
116
|
-
client.send(command).then(
|
|
117
|
-
(data) => {
|
|
118
|
-
// process data.
|
|
119
|
-
},
|
|
120
|
-
(error) => {
|
|
121
|
-
// error handling.
|
|
122
|
-
}
|
|
123
|
-
);
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
Promises can also be called using `.catch()` and `.finally()` as follows:
|
|
110
|
+
You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining).
|
|
127
111
|
|
|
128
112
|
```js
|
|
129
113
|
client
|
|
@@ -139,27 +123,21 @@ client
|
|
|
139
123
|
});
|
|
140
124
|
```
|
|
141
125
|
|
|
142
|
-
####
|
|
143
|
-
|
|
144
|
-
We do not recommend using callbacks because of [callback hell](http://callbackhell.com/),
|
|
145
|
-
but they are supported by the send operation.
|
|
126
|
+
#### Aggregated client
|
|
146
127
|
|
|
147
|
-
|
|
148
|
-
// callbacks.
|
|
149
|
-
client.send(command, (err, data) => {
|
|
150
|
-
// process err and data.
|
|
151
|
-
});
|
|
152
|
-
```
|
|
128
|
+
The aggregated client class is exported from the same package, but without the "Client" suffix.
|
|
153
129
|
|
|
154
|
-
|
|
130
|
+
`SSM` extends `SSMClient` and additionally supports all operations, waiters, and paginators as methods.
|
|
131
|
+
This style may be familiar to you from the AWS SDK for JavaScript v2.
|
|
155
132
|
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
133
|
+
If you are bundling the AWS SDK, we recommend using only the bare-bones client (`SSMClient`).
|
|
134
|
+
More details are in the blog post on
|
|
135
|
+
[modular packages in AWS SDK for JavaScript](https://aws.amazon.com/blogs/developer/modular-packages-in-aws-sdk-for-javascript/).
|
|
159
136
|
|
|
160
137
|
```ts
|
|
161
|
-
import
|
|
162
|
-
|
|
138
|
+
import { SSM } from "@aws-sdk/client-ssm";
|
|
139
|
+
|
|
140
|
+
const client = new SSM({ region: "REGION" });
|
|
163
141
|
|
|
164
142
|
// async/await.
|
|
165
143
|
try {
|
|
@@ -179,7 +157,7 @@ client
|
|
|
179
157
|
// error handling.
|
|
180
158
|
});
|
|
181
159
|
|
|
182
|
-
// callbacks.
|
|
160
|
+
// callbacks (not recommended).
|
|
183
161
|
client.listNodes(params, (err, data) => {
|
|
184
162
|
// process err and data.
|
|
185
163
|
});
|
|
@@ -207,12 +185,14 @@ try {
|
|
|
207
185
|
}
|
|
208
186
|
```
|
|
209
187
|
|
|
188
|
+
See also [docs/ERROR_HANDLING](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/ERROR_HANDLING.md).
|
|
189
|
+
|
|
210
190
|
## Getting Help
|
|
211
191
|
|
|
212
192
|
Please use these community resources for getting help.
|
|
213
|
-
We use
|
|
193
|
+
We use GitHub issues for tracking bugs and feature requests, but have limited bandwidth to address them.
|
|
214
194
|
|
|
215
|
-
- Visit [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
|
|
195
|
+
- Visit the [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
|
|
216
196
|
or [API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/index.html).
|
|
217
197
|
- Check out the blog posts tagged with [`aws-sdk-js`](https://aws.amazon.com/blogs/developer/tag/aws-sdk-js/)
|
|
218
198
|
on AWS Developer Blog.
|