Dépannage des opérations d’APITroubleshooting API operations

Les sections suivantes offrent des conseils de dépannage pour les opérations d'API :The following sections offer troubleshooting tips for API operations:

Traçage de la demande échouéFailed Request Tracing

L'en-tête x-ms-request-idThe x-ms-request-id Header

Suivi des demandes ayant échouéFailed Request Tracing

L'environnement de développement prend en charge l'utilisation de la fonctionnalité de suivi des demandes ayant échoué de IIS 7.0 (Internet Information Services) pour enregistrer les informations relatives aux demandes.The development environment supports the use of the Internet Information Services (IIS) 7.0 Failed Request Tracing feature to log information about requests. Le suivi des demandes ayant échoué produit des journaux de suivi détaillés en fonction de filtres établis au sein de la configuration d'un rôle web.Failed Request Tracing produces detailed trace logs according to filters established within a web role’s configuration.

Destination de l'enregistrementLogging Destination

Windows Azure place les fichiers journaux de suivi dans le répertoire IIS par défaut pour les journaux de demandes ayant échoué.Windows Azure outputs trace log files to the default IIS directory for failed request logs. Par défaut, ce répertoire est %SystemDrive%\inetpub\logs\FailedReqLogFiles.This directory by default is %SystemDrive%\inetpub\logs\FailedReqLogFiles.

Activation du traçageEnabling Tracing

Chaque rôle web doit activer le suivi en utilisant des règles placées dans le fichier Web.config du projet.Each web role must enable tracing by using rules placed in the project's web.config file. Pour activer le suivi, placez le code suivant dans la section system.webServer de votre fichier Web.config :To enable tracing, place the following in the system.webServer section of your web.config file:

<tracing>  
  <traceFailedRequests>  
    <add path="*">  
      <traceAreas>  
        <add provider="ASP" verbosity="Verbose" />  
        <add provider="ASPNET" areas="Infrastructure,Module,Page,AppServices" verbosity="Verbose" />  
        <add provider="ISAPI Extension" verbosity="Verbose" />  
        <add provider="WWW Server" areas="Authentication,Security,Filter,StaticFile,CGI,Compression,Cache,RequestNotifications,Module" verbosity="Verbose" />  
      </traceAreas>  
      <failureDefinitions statusCodes="400-599" />  
    </add>  
  </traceFailedRequests>  
</tracing>  

Pour désactiver le suivi, supprimez cette section du fichier Web.config.To disable tracing, remove this section from the web.config file.

L'en-tête x-ms-request-idThe x-ms-request-id Header

Chaque demande adressée aux services de stockage renvoie un en-tête de réponse nommé x-ms-request-id.Every request made against the storage services returns a response header named x-ms-request-id. Cet en-tête contient une valeur opaque qui identifie de façon unique la requête.This header contains an opaque value that uniquely identifies the request.

Si une requête échoue constamment et que vous avez vérifié qu'elle est formulée correctement, vous pouvez utiliser cette valeur pour signaler l'erreur à Microsoft.If a request is consistently failing and you have verified that the request is properly formulated, you may use this value to report the error to Microsoft. Dans votre rapport, incluez la valeur de x-ms-request-id, l'heure approximative de la demande, le service de stockage sur lequel la demande a été effectuée, et le type d'opération que la demande a essayé.In your report, include the value of x-ms-request-id, the approximate time that the request was made, the storage service against which the request was made, and the type of operation that the request attempted.

 Voir aussiSee Also

Services de stockage RESTStorage Services REST