Skip to main content
This example uses AWSSDK.S3. Your code keeps using IAmazonS3; the client configuration directs requests to Cloud Adapter.

Choose how to set the endpoint

Set it for the process

AWS SDK for .NET reads the service-specific setting when ServiceURL is not assigned:

Set it on one client

ServiceURL selects the adapter endpoint. AuthenticationRegion keeps AWS signing behavior explicit. The adapter’s target-cloud identity remains in service adapter configuration, not in the .NET process. An explicit ServiceURL takes precedence over AWS_ENDPOINT_URL_S3.

Verify a lifecycle

Inspect the native target object after the put. Record put.ResponseMetadata.RequestId, put.HttpStatusCode, the target object name, and the adapter version with your test evidence.

Handle errors

Network and cancellation failures may have no service response. Do not treat missing response metadata as a translated AWS error. After a timeout on a mutation, inspect target state before retrying.

Production checklist

  • Reuse IAmazonS3; do not construct a client per request.
  • Pass cancellation tokens from the application boundary.
  • Test the exact retry, paginator, multipart, and conditional behaviors you use.
  • Keep origin credentials and backend credentials separate.
  • Do not log signed headers, request bodies, or secret values.
  • Compare operations with S3 target coverage.
Use Debugging Your Adapters when the SDK response and native target state disagree.