aws availability_error ai_generated partial

An error occurred (ServiceUnavailableException) when calling the X operation

ID: aws/service-unavailable

Also available as: JSON · Markdown
75%Fix Rate
85%Confidence
50Evidence
2023-01-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
2 active

Root Cause

AWS service is temporarily unavailable. Usually a transient issue.

generic

Workarounds

  1. 92% success Implement exponential backoff with jitter and retry
    import boto3
    from botocore.config import Config
    
    config = Config(
        retries={'max_attempts': 10, 'mode': 'adaptive'}
    )
    client = boto3.client('s3', config=config)
    
    # For custom retry logic, use full jitter: sleep = random(0, min(cap, base * 2^attempt))
    # AWS SDK adaptive mode handles this automatically.

    Sources: https://docs.aws.amazon.com/general/latest/gr/api-retries.html

  2. 90% success Check AWS Health Dashboard for ongoing service incidents
    Check AWS Health Dashboard for ongoing service incidents

    Sources: https://health.aws.amazon.com/health/status

  3. 78% success If persistent, try a different AWS region as failover
    # Switch to a different region temporarily:
    aws s3 ls --region us-west-2
    
    # Or set in code:
    client = boto3.client('s3', region_name='us-west-2')
    
    # Check which regions the service supports:
    aws ec2 describe-regions --query 'Regions[].RegionName'
    
    Note: data residency and latency may change. Only use as temporary failover.

    Sources: https://docs.aws.amazon.com/general/latest/gr/rande.html

Dead Ends

Common approaches that don't work:

  1. Switch to a different AWS service 90% fail

    Likely a temporary issue — switching services is a massive change

  2. Increase request timeout 65% fail

    The service is unavailable — waiting longer per-request doesn't help

Error Chain

Frequently confused with: