クイックスタート: メール送信層の制限に達したときに例外をスローする

メール送信層の制限に達したときに例外をスローする

Email API には調整があり、送信できる電子メール メッセージの数に制限があります。 メールの送信には、API の調整とタイムアウトに関するページで説明されているように、1 分あたりと 1 時間あたりの制限が適用されます。 これらの制限に達すると、SendAsync 呼び出しを使用した以降のメール送信では、"429: 要求が多すぎます" というエラー応答が返されます。 既定では、SDK は、一定期間待機した後にこれらの要求を再試行するように構成されています。 これらの応答コードをキャプチャするために、Azure SDK でログ記録を設定することをお勧めします。

または、以下のようにカスタム ポリシーを手動で定義することもできます。

using Azure.Core.Pipeline;

public class Catch429Policy : HttpPipelineSynchronousPolicy
{
    public override void OnReceivedResponse(HttpMessage message)
    {
        if (message.Response.Status == 429)
        {
            throw new Exception(message.Response);
        }
        else
        {
            base.OnReceivedResponse(message);
        }
    }
}

このポリシーをメール クライアントに追加して、429 の応答コードで再試行されるのではなく例外がスローされるようにします。

EmailClientOptions emailClientOptions = new EmailClientOptions();
emailClientOptions.AddPolicy(new Catch429Policy(), HttpPipelinePosition.PerRetry);

EmailClient emailClient = new EmailClient(connectionString, emailClientOptions);

メール送信層の制限に達したときに例外をスローする

Email API には調整があり、送信できる電子メール メッセージの数に制限があります。 メールの送信には、API の調整とタイムアウトに関するページで説明されているように、1 分あたりと 1 時間あたりの制限が適用されます。 これらの制限に達すると、send 呼び出しを使用した以降のメール送信では、"429: 要求が多すぎます" というエラー応答が返されます。 既定では、SDK は、一定期間待機した後にこれらの要求を再試行するように構成されています。 これらの応答コードをキャプチャするために、Azure SDK でログ記録を設定することをお勧めします。

Azure Communication Email Service を使用して送信できるメールの量には、1 分あたりと 1 時間あたりの制限があります。 これらの制限に達すると、それ以降の beginSend 呼び出しでは 429: Too Many Requests 応答が返されます。 既定では、SDK は、一定期間待機した後にこれらの要求を再試行するように構成されています。 これらの応答コードをキャプチャするために、Azure SDK でログ記録を設定することをお勧めします。

または、以下のようにカスタム ポリシーを手動で定義することもできます。

const catch429Policy = {
  name: "catch429Policy",
  async sendRequest(request, next) {
    const response = await next(request);
    if (response.status === 429) {
      throw new Error(response);
    }
    return response;
  }
};

このポリシーをメール クライアントに追加して、429 の応答コードで再試行されるのではなく例外がスローされるようにします。

const clientOptions = {
  additionalPolicies: [
    {
      policy: catch429Policy,
      position: "perRetry"
    }
  ]
}

const emailClient = new EmailClient(connectionString, clientOptions);

メール送信層の制限に達したときに例外をスローする

Email API には調整があり、送信できる電子メール メッセージの数に制限があります。 メールの送信には、API の調整とタイムアウトに関するページで説明されているように、1 分あたりと 1 時間あたりの制限が適用されます。 これらの制限に達すると、beginSend 呼び出しを使用した以降のメール送信では、"429: 要求が多すぎます" というエラー応答が返されます。 既定では、SDK は、一定期間待機した後にこれらの要求を再試行するように構成されています。 これらの応答コードをキャプチャするために、Azure SDK でログ記録を設定することをお勧めします。

または、以下のようにカスタム ポリシーを手動で定義することもできます。

import com.azure.core.http.HttpResponse;
import com.azure.core.http.policy.ExponentialBackoff;

public class CustomStrategy extends ExponentialBackoff {
    @Override
    public boolean shouldRetry(HttpResponse httpResponse) {
        int code = httpResponse.getStatusCode();

        if (code == HTTP_STATUS_TOO_MANY_REQUESTS) {
            throw new RuntimeException(httpResponse);
        }
        else {
            return super.shouldRetry(httpResponse);
        }
    }
}

この再試行ポリシーをメール クライアントに追加して、429 の応答コードで再試行されるのではなく例外がスローされるようにします。

import com.azure.core.http.policy.RetryPolicy;

EmailClient emailClient = new EmailClientBuilder()
    .connectionString(connectionString)
    .retryPolicy(new RetryPolicy(new CustomStrategy()))
    .buildClient();

メール送信層の制限に達したときに例外をスローする

Email API には調整があり、送信できる電子メール メッセージの数に制限があります。 メールの送信には、API の調整とタイムアウトに関するページで説明されているように、1 分あたりと 1 時間あたりの制限が適用されます。 これらの制限に達すると、SendAsync 呼び出しを使用した以降のメール送信では、"429: 要求が多すぎます" というエラー応答が返されます。 既定では、SDK は、一定期間待機した後にこれらの要求を再試行するように構成されています。 これらの応答コードをキャプチャするために、Azure SDK でログ記録を設定することをお勧めします。

または、カスタム ポリシーを手動で定義して、429 の応答コードで再試行されるのではなく例外がスローされるようにすることもできます。

def callback(response):
    if response.http_response.status_code == 429:
        raise Exception(response.http_response)

email_client = EmailClient.from_connection_string(<connection_string>, raw_response_hook=callback)