Guida introduttiva: Generare un'eccezione quando viene raggiunto il limite del livello di invio della posta elettronica

Generare un'eccezione quando viene raggiunto il limite del livello di invio di posta elettronica

L'API Email presenta limitazioni per il numero di messaggi di posta elettronica che è possibile inviare. Email l'invio ha limiti applicati al minuto e all'ora, come indicato in Limitazioni API e timeout. Quando sono stati raggiunti questi limiti, i messaggi di posta elettronica successivi inviati con SendAsync chiamate ricevono una risposta di errore "429: Troppe richieste". Per impostazione predefinita, l'SDK è configurato per ritentare queste richieste dopo un determinato periodo di tempo. È consigliabile configurare la registrazione con Azure SDK per acquisire questi codici di risposta.

In alternativa, è possibile definire manualmente un criterio personalizzato:

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);
        }
    }
}

Aggiungere questo criterio al client di posta elettronica per assicurarsi che i codici di risposta 429 generino un'eccezione anziché essere ritentati.

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

EmailClient emailClient = new EmailClient(connectionString, emailClientOptions);

Generare un'eccezione quando viene raggiunto il limite del livello di invio di posta elettronica

L'API Email presenta limitazioni per il numero di messaggi di posta elettronica che è possibile inviare. Email l'invio ha limiti applicati al minuto e all'ora, come indicato in Limitazioni API e timeout. Quando sono stati raggiunti questi limiti, i messaggi di posta elettronica successivi inviati con send chiamate ricevono una risposta di errore "429: Troppe richieste". Per impostazione predefinita, l'SDK è configurato per ritentare queste richieste dopo un determinato periodo di tempo. È consigliabile configurare la registrazione con Azure SDK per acquisire questi codici di risposta.

Esistono limiti al minuto e all'ora per la quantità di messaggi di posta elettronica che è possibile inviare usando il servizio Di comunicazione di Azure Email. Quando si raggiungono questi limiti, tutte le altre beginSend chiamate ricevono una 429: Too Many Requests risposta. Per impostazione predefinita, l'SDK è configurato per ritentare queste richieste dopo un determinato periodo di tempo. È consigliabile configurare la registrazione con Azure SDK per acquisire questi codici di risposta.

In alternativa, è possibile definire manualmente un criterio personalizzato:

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

Aggiungere questo criterio al client di posta elettronica per assicurarsi che i codici di risposta 429 generino un'eccezione anziché essere ritentati.

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

const emailClient = new EmailClient(connectionString, clientOptions);

Generare un'eccezione quando viene raggiunto il limite del livello di invio di posta elettronica

L'API Email presenta limitazioni per il numero di messaggi di posta elettronica che è possibile inviare. Email l'invio ha limiti applicati al minuto e all'ora, come indicato in Limitazioni API e timeout. Quando sono stati raggiunti questi limiti, i messaggi di posta elettronica successivi inviati con beginSend chiamate ricevono una risposta di errore "429: Troppe richieste". Per impostazione predefinita, l'SDK è configurato per ritentare queste richieste dopo un determinato periodo di tempo. È consigliabile configurare la registrazione con Azure SDK per acquisire questi codici di risposta.

In alternativa, è possibile definire manualmente un criterio personalizzato:

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);
        }
    }
}

Aggiungere questo criterio di ripetizione dei tentativi al client di posta elettronica per assicurarsi che i codici di risposta 429 generino un'eccezione anziché essere ritentati.

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

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

Generare un'eccezione quando viene raggiunto il limite del livello di invio di posta elettronica

L'API Email presenta limitazioni per il numero di messaggi di posta elettronica che è possibile inviare. Email l'invio ha limiti applicati al minuto e all'ora, come indicato in Limitazioni API e timeout. Quando sono stati raggiunti questi limiti, i messaggi di posta elettronica successivi inviati con SendAsync chiamate ricevono una risposta di errore "429: Troppe richieste". Per impostazione predefinita, l'SDK è configurato per ritentare queste richieste dopo un determinato periodo di tempo. È consigliabile configurare la registrazione con Azure SDK per acquisire questi codici di risposta.

In alternativa, è possibile definire manualmente un criterio personalizzato per garantire che 429 codici di risposta generino un'eccezione anziché essere ritentati.

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)