AWS SDK Error Handling, Retries, Pagination आणि Waiters (Python, PHP, Node.js)

By Ravindra Bagale, trainer · LinkedIn · Last updated: 24 October 2026

1. मोठं चित्र: courier delivery

हे का लागतं?

Madrid मध्ये Carlos ची bakery आहे, तो courier ने cakes पाठवतो. दार कोणी उघडलं नाही तर courier नंतर परत येतो (retry). Address च नसेल तर परत येण्यात अर्थ नाही (खरा error). मोठी order अनेक vans मध्ये जाते (pages). आणि parcel "delivered" दिसेपर्यंत तो customer ला फोन करत नाही (waiter).

हे काय आहे?

प्रत्येक SDK error code (NoSuchBucket, AccessDenied, ThrottlingException) आणि HTTP status सह typed error देतो. Throttling आणि 5xx errors आपोआप retry होतात. AccessDenied सारखे 4xx होत नाहीत.

कसं करायचं (step by step)

2. Code नुसार errors catch करा

हे का लागतं?

User typo असलेल्या bucket नावावर upload करतो. Stack trace नको, स्पष्ट message हवा.

हे काय आहे?

boto3 botocore.exceptions.ClientError देतो; PHP Aws\Exception\AwsException; Node मध्ये error.name = code आणि $metadata.httpStatusCode = status.

कसं करायचं (step by step)

1. Python: ClientError catch करून code वाचा.

import boto3
from botocore.exceptions import ClientError

s3 = boto3.client("s3", region_name="eu-west-1")
try:
    s3.head_bucket(Bucket="carlos-bakery-no-such-bucket")
except ClientError as e:
    code = e.response["Error"]["Code"]
    status = e.response["ResponseMetadata"]["HTTPStatusCode"]
    print("Failed:", code, status)

अपेक्षित output:

Failed: 404 404

2. Python: वेगवेगळे codes वेगळे हाताळा.

import boto3
from botocore.exceptions import ClientError

ddb = boto3.client("dynamodb", region_name="eu-west-1")
try:
    ddb.describe_table(TableName="Orders-Missing")
except ClientError as e:
    if e.response["Error"]["Code"] == "ResourceNotFoundException":
        print("Table not found, create it first")
    else:
        raise

अपेक्षित output:

Table not found, create it first

3. PHP: AwsException catch करा.

<?php
require "vendor/autoload.php";
use Aws\DynamoDb\DynamoDbClient;
use Aws\Exception\AwsException;

$ddb = new DynamoDbClient(["region" => "eu-west-1"]);
try {
    $ddb->describeTable(["TableName" => "Orders-Missing"]);
} catch (AwsException $e) {
    echo "Failed: ", $e->getAwsErrorCode(), " ", $e->getStatusCode(), PHP_EOL;
}

अपेक्षित output:

Failed: ResourceNotFoundException 400

4. Node.js: error.name आणि HTTP status तपासा.

import { DynamoDBClient, DescribeTableCommand } from "@aws-sdk/client-dynamodb";

const ddb = new DynamoDBClient({ region: "eu-west-1" });
try {
  await ddb.send(new DescribeTableCommand({ TableName: "Orders-Missing" }));
} catch (err) {
  console.log("Failed:", err.name, err.$metadata?.httpStatusCode);
}

अपेक्षित output:

Failed: ResourceNotFoundException 400

5. Verify: CLI तोच code दाखवतो.

aws dynamodb describe-table --table-name Orders-Missing --region eu-west-1 2>&1 | head -2

अपेक्षित output:

An error occurred (ResourceNotFoundException) when calling the DescribeTable operation: Requested resource not found

3. Retries आणि timeouts

हे का लागतं?

Flash sale मध्ये सेकंदाला हजारो writes, काही throttle होतात. Slow network मुळे web request मिनिटभर अडकू नये.

हे काय आहे?

Retry modes: legacy, standard (नव्या SDKs मध्ये default) आणि adaptive (client-side rate limiting). Client वर max attempts आणि connect/read timeouts द्या.

कसं करायचं (step by step)

1. Python: botocore Config द्या.

import boto3
from botocore.config import Config

cfg = Config(
    retries={"max_attempts": 5, "mode": "adaptive"},
    connect_timeout=3,
    read_timeout=10,
)
s3 = boto3.client("s3", region_name="us-east-1", config=cfg)
print(s3.meta.config.retries)

अपेक्षित output:

{'max_attempts': 5, 'mode': 'adaptive'}

2. PHP: retries आणि http timeouts द्या.

<?php
require "vendor/autoload.php";
use Aws\S3\S3Client;

$s3 = new S3Client([
    "region"  => "us-east-1",
    "retries" => ["mode" => "standard", "max_attempts" => 5],
    "http"    => ["connect_timeout" => 3, "timeout" => 10],
]);
echo "Client ready with 5 attempts", PHP_EOL;

अपेक्षित output:

Client ready with 5 attempts

3. Node.js: maxAttempts, retryMode आणि timeouts सह request handler.

import { S3Client } from "@aws-sdk/client-s3";
import { NodeHttpHandler } from "@smithy/node-http-handler";

const s3 = new S3Client({
  region: "us-east-1",
  maxAttempts: 5,
  retryMode: "adaptive",
  requestHandler: new NodeHttpHandler({ connectionTimeout: 3000, requestTimeout: 10000 }),
});
console.log("maxAttempts:", await s3.config.maxAttempts());

अपेक्षित output:

maxAttempts: 5

4. किंवा सगळ्या SDKs साठी env vars ने retries.

export AWS_RETRY_MODE=standard
export AWS_MAX_ATTEMPTS=5
python -c "import boto3;print(boto3.client('s3').meta.config.retries)"

अपेक्षित output:

{'mode': 'standard', 'total_max_attempts': 5}

5. Verify: response मध्ये किती retries झाले ते पाहा.

import boto3
r = boto3.client("s3").list_buckets()
print("Retries:", r["ResponseMetadata"]["RetryAttempts"])

अपेक्षित output:

Retries: 0

4. Pagination

हे का लागतं?

London मधल्या agency च्या bucket मध्ये 2,500 objects, पण एक ListObjectsV2 call जास्तीत जास्त 1,000 देतो. Pagination नसेल तर data चुपचाप सुटतो.

हे काय आहे?

प्रत्येक SDK कडे paginators आहेत जे NextToken / ContinuationToken आपोआप follow करतात: boto3 get_paginator, PHP getPaginator, Node paginateListObjectsV2.

कसं करायचं (step by step)

1. Python: paginator ने सगळे objects मोजा.

import boto3

s3 = boto3.client("s3")
pages = s3.get_paginator("list_objects_v2").paginate(Bucket="london-agency-assets")
total = 0
for page in pages:
    total += page.get("KeyCount", 0)
print("Objects:", total)

अपेक्षित output:

Objects: 2500

2. PHP: getPaginator.

<?php
require "vendor/autoload.php";
$s3 = new Aws\S3\S3Client(["region" => "eu-west-2"]);
$total = 0;
foreach ($s3->getPaginator("ListObjectsV2", ["Bucket" => "london-agency-assets"]) as $page) {
    $total += $page["KeyCount"];
}
echo "Objects: $total", PHP_EOL;

अपेक्षित output:

Objects: 2500

3. Node.js: paginateListObjectsV2 वर for await.

import { S3Client, paginateListObjectsV2 } from "@aws-sdk/client-s3";

const s3 = new S3Client({ region: "eu-west-2" });
let total = 0;
for await (const page of paginateListObjectsV2({ client: s3 }, { Bucket: "london-agency-assets" })) {
  total += page.KeyCount ?? 0;
}
console.log("Objects:", total);

अपेक्षित output:

Objects: 2500

4. Verify: CLI count जुळतो.

aws s3api list-objects-v2 --bucket london-agency-assets --query "length(Contents)"

अपेक्षित output:

2500

5. Waiters

हे का लागतं?

DynamoDB table बनवल्यावर किंवा EC2 launch केल्यावर वापरण्याआधी तो ready होईपर्यंत थांबावं लागतं.

हे काय आहे?

Waiter describe call ठराविक delay ने poll करतो, success state येईपर्यंत; नाही आलं तर नीट fail होतो.

कसं करायचं (step by step)

1. Python: table exist होईपर्यंत wait.

import boto3

ddb = boto3.client("dynamodb", region_name="eu-west-1")
waiter = ddb.get_waiter("table_exists")
waiter.wait(TableName="Orders", WaiterConfig={"Delay": 5, "MaxAttempts": 24})
print("Orders table is ACTIVE")

अपेक्षित output:

Orders table is ACTIVE

2. PHP: waitUntil.

<?php
require "vendor/autoload.php";
$ddb = new Aws\DynamoDb\DynamoDbClient(["region" => "eu-west-1"]);
$ddb->waitUntil("TableExists", ["TableName" => "Orders", "@waiter" => ["delay" => 5, "maxAttempts" => 24]]);
echo "Orders table is ACTIVE", PHP_EOL;

अपेक्षित output:

Orders table is ACTIVE

3. Node.js: waitUntilTableExists.

import { DynamoDBClient, waitUntilTableExists } from "@aws-sdk/client-dynamodb";

const ddb = new DynamoDBClient({ region: "eu-west-1" });
const r = await waitUntilTableExists({ client: ddb, maxWaitTime: 120 }, { TableName: "Orders" });
console.log("Waiter state:", r.state);

अपेक्षित output:

Waiter state: SUCCESS

4. Verify: status ACTIVE.

aws dynamodb describe-table --table-name Orders --region eu-west-1 --query Table.TableStatus --output text

अपेक्षित output:

ACTIVE

6. Logging आणि request IDs

हे का लागतं?

AWS Support "request ID काय होता?" विचारतो, किंवा call slow असतो, तेव्हा SDK ने काय पाठवलं ते दिसायला हवं.

हे काय आहे?

boto3 मध्ये set_stream_logger; PHP मध्ये debug option; Node ला console सारखा logger. प्रत्येक response मध्ये RequestId.

कसं करायचं (step by step)

1. Python: botocore साठी debug logs.

import boto3, logging

boto3.set_stream_logger("botocore", logging.DEBUG)
r = boto3.client("sts").get_caller_identity()
print("RequestId:", r["ResponseMetadata"]["RequestId"])

अपेक्षित output:

DEBUG - botocore.endpoint - Making request for OperationModel(name=GetCallerIdentity)
...
RequestId: 4c1d7a2e-9b1f-4f5e-a3c2-1d2e3f4a5b6c

2. PHP: debug option HTTP wire print करतो.

<?php
require "vendor/autoload.php";
$sts = new Aws\Sts\StsClient(["region" => "us-east-1", "debug" => ["logfn" => fn($m) => error_log($m), "http" => true]]);
$r = $sts->getCallerIdentity();
echo "RequestId: ", $r["@metadata"]["headers"]["x-amzn-requestid"], PHP_EOL;

अपेक्षित output:

RequestId: 4c1d7a2e-9b1f-4f5e-a3c2-1d2e3f4a5b6c

3. Node.js: logger म्हणून console.

import { STSClient, GetCallerIdentityCommand } from "@aws-sdk/client-sts";
const sts = new STSClient({ region: "us-east-1", logger: console });
const r = await sts.send(new GetCallerIdentityCommand({}));
console.log("RequestId:", r.$metadata.requestId);

अपेक्षित output:

{ clientName: 'STSClient', commandName: 'GetCallerIdentityCommand', ... }
RequestId: 4c1d7a2e-9b1f-4f5e-a3c2-1d2e3f4a5b6c

7. हाच call Java, Go, .NET आणि CLI मध्ये

हे का लागतं?

Teams अनेकदा भाषा मिसळतात. Python, PHP आणि Node.js मध्ये call समजला की बाकीचे SDKs म्हणजे तोच API, फक्त syntax वेगळा.

हे काय आहे?

सगळे ListObjectsV2 with pagination API call करतात. Terminal मधून पटकन test करायला CLI ओळ वापरा.

कसं करायचं (step by step)

8. काहीही खर्च चालू राहू नये म्हणून cleanup

हे का लागतं?

चालू ठेवलेले lab resources पैसे खातात आणि security risk बनतात.

हे काय आहे?

उलट्या क्रमाने delete करा: आधी children, मग parents.

कसं करायचं (step by step)

1. Retry env vars काढा.

unset AWS_RETRY_MODE AWS_MAX_ATTEMPTS
env | grep -c AWS_MAX_ATTEMPTS

अपेक्षित output:

0

9. मुलाखत प्रश्न आणि उत्तरं

उजळणी, तुलना आणि मुलाखत cards

हा lesson काही मिनिटांत revise करा. Cards phone वर save करा किंवा PNG download करा. प्रत्येक card वरचा QR हा lesson उघडतो.

अजून cards: Ravi Sir's Cards.