Web Apps - Start Web Site Network Trace Operation

開始擷取月台網路封包的描述。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/networkTrace/startOperation?api-version=2023-01-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/networkTrace/startOperation?durationInSeconds={durationInSeconds}&maxFrameLength={maxFrameLength}&sasUrl={sasUrl}&api-version=2023-01-01

URI 參數

名稱 位於 必要 類型 Description
name
path True

string

Web 應用程式的名稱。

resourceGroupName
path True

string

資源所屬資源群組的名稱。

Regex pattern: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

您的 Azure 訂用帳戶識別碼。 這是 GUID 格式的字串 (例如 0000000000-0000-0000-0000-0000000000000) 。

api-version
query True

string

API 版本

durationInSeconds
query

integer

int32

要持續擷取的持續時間,以秒為單位。

maxFrameLength
query

integer

int32

以位元組為單位的最大畫面長度, (選擇性) 。

sasUrl
query

string

用來儲存擷取檔案的 Blob URL。

回應

名稱 類型 Description
200 OK

NetworkTrace[]

確定

202 Accepted

NetworkTrace[]

作業正在進行中。

Other Status Codes

DefaultErrorResponse

App Service 錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Start a new network trace operation for a site

Sample Request

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/SampleApp/networkTrace/startOperation?durationInSeconds=60&api-version=2023-01-01

Sample Response

[
  {
    "path": "D:\\home\\LogFiles\\networktrace\\10.0.0.1_2018_02_01T00_00_00.zip",
    "status": "Succeeded",
    "message": "Trace file has been saved as D:\\home\\LogFiles\\networktrace\\10.0.0.1_2018_02_01T00_00_00.zip"
  }
]
location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/SampleApp/operationresults/c291433b-53ad-4c49-8cae-0a293eae1c6d
azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/SampleApp/operationresults/c291433b-53ad-4c49-8cae-0a293eae1c6d
[
  {
    "path": "D:\\home\\LogFiles\\networktrace\\10.0.0.1_2018_02_01T00_00_00.zip",
    "status": "Succeeded",
    "message": "Trace file has been saved as D:\\home\\LogFiles\\networktrace\\10.0.0.1_2018_02_01T00_00_00.zip"
  }
]

定義

名稱 Description
DefaultErrorResponse

App Service 錯誤回應。

Details
Error

錯誤模型。

NetworkTrace

網路追蹤

DefaultErrorResponse

App Service 錯誤回應。

名稱 類型 Description
error

Error

錯誤模型。

Details

名稱 類型 Description
code

string

標準化字串,以程序設計方式識別錯誤。

message

string

詳細的錯誤描述和偵錯資訊。

target

string

詳細的錯誤描述和偵錯資訊。

Error

錯誤模型。

名稱 類型 Description
code

string

標準化字串,以程序設計方式識別錯誤。

details

Details[]

詳細的錯誤。

innererror

string

偵錯錯誤的詳細資訊。

message

string

詳細的錯誤描述和偵錯資訊。

target

string

詳細的錯誤描述和偵錯資訊。

NetworkTrace

網路追蹤

名稱 類型 Description
message

string

網路追蹤作業的詳細訊息,例如發生失敗時的錯誤訊息。

path

string

所擷取網路追蹤檔案的本機檔案路徑。

status

string

網路追蹤作業的目前狀態,與 Operation.Status (InProgress/Succeeded/Failed/Failed) 相同。