針對 API 作業進行疑難排解

發行項
08/05/2023

下列各節提供 API 作業的疑難排解秘訣。

失敗的要求追蹤

開發環境支援使用 Internet Information Services (IIS) 7.0 的功能來記錄要求的相關資訊。此功能稱為 失敗的要求追蹤，並根據 Web 角色設定內建立的篩選產生詳細的追蹤記錄。

記錄目的地

Azure 將追蹤記錄檔輸出至失敗要求記錄檔的預設 IIS 目錄。根據預設，此目錄為 %SystemDrive%\inetpub\logs\FailedReqLogFiles。

啟用追蹤

每個 Web 角色都必須使用專案 web.config 檔案中放置的規則來啟用追蹤。若要啟用追蹤，請將下列內容 system.webServer 放在 web.config 檔案的區段中：

<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>

若要停用追蹤，請從 web.config 檔案中移除此區段。

x-ms-request-id 標頭

針對 Azure 儲存體提出的每個要求都會傳回名為的 x-ms-request-id 回應標頭。此標頭包含專門識別要求的不透明值。

如果要求持續失敗，而且您已確認已正確制定要求，您可以使用此值向 Microsoft 回報錯誤。在您的報表中，包含下列資訊：

x-ms-request-id 的值。
提出要求的大約時間。
發出要求的儲存體服務。
要求嘗試的作業類型。

另請參閱

儲存體服務 REST

共用方式為