Runbook: Investigate Provider API Rate Limiting

1 · Prerequisites

Confirm every item is in place before any state change.

• The apply is rate-limited
• The provider has rate limits

2 · Pre-checks

Read-only diagnostic commands. If any of these don't match expected output, stop and investigate further.

• · The error is a rate-limit error
• · The provider has rate limits

3 · Procedure

Execute each step in order. Verify the expected output of a step before moving to the next.

1. 1Identify the rate limit
2. 2Reduce the parallelism with -parallelism
3. 3Wait for the rate limit to reset
4. 4Re-run the apply
5. 5Document the rate-limit incident

4 · Verification

Confirm the procedure actually fixed the problem.

• ✓The apply completes
• ✓The rate limit is respected
• ✓The incident is documented

5 · Rollback

If verification fails, undo the procedure in reverse order.

• ↶If the rate limit persists, escalate to the provider team

6 · Escalation

When the runbook isn't enough, contact:

• · If the rate limit is a recurring issue, escalate to the platform team