aws-sdk-swift-usage
AWS SDK for Swift development patterns. Use when writing Swift code that uses AWS services via aws-sdk-swift package.
By aws · 5,016 installs
npx skills add aws/agent-toolkit-for-aws --skill aws-sdk-swift-usage
Source repository · Upstream listing
AWS SDK for Swift
Async Code Structure
All SDK operations are async. Use @main entry point:
CRITICAL: Use Struct Config Types
NEVER use S3ClientConfiguration or DynamoDBClientConfiguration these are DEPRECATED classes.
ALWAYS use the struct based config types:
S3Client.S3ClientConfig (not S3ClientConfiguration)
DynamoDBClient.DynamoDBClientConfig (not DynamoDBClientConfiguration)
STSClient.STSClientConfig (not STSClientConfiguration)
Config parameters MUST be in declaration order. Region is ALWAYS required when creating a config. Check the service client source for exact order.
Client Creation
All service clients follow the same pattern: <Service Client with <Service Client.<Service ClientConfig .
Model types (structs/enums used in requests/responses) are namespaced under <Service ClientTypes :
S3ClientTypes.Bucket , S3ClientTypes.Object
DynamoDBClientTypes.AttributeValue
CloudWatchClientTypes.MetricDatum , CloudWatchClientTypes.Dimension
Common config parameters (MUST follow declaration order):
awsCredentialIdentityResolver Custom credentials
useFIPS Enable FIPS endpoints
useDualStack Enable dual stack endpoints
awsRetryMode Retry strategy (.adaptive, .standard, .legacy)
maxAttempts Max retry attempts
region AWS region
httpClientEngine Custom HTTP client (requires HttpClientConfiguration parameter):
endpoint Custom endpoint URL
For service specific config options or exact parameter order, check Sources/Services/AWS<Service /Sources/AWS<Service /<Service Client.swift in the SDK.
Credential Resolvers
Waiters
Import SmithyWaitersAPI . WaiterOptions requires maxWaitTime parameter:
Pagination
Presigned URLs
Common Operations