Azure Logic Apps 中觸發程式和動作類型的架構參考指南

發行項
03/14/2023

此參考描述用來識別邏輯應用程式基礎工作流程定義中觸發程式和動作的一般類型，這些類型是由工作流程定義語言所描述和驗證。若要尋找您可以在邏輯應用程式中使用的特定連接器觸發程式和動作，請參閱連接器概觀下方的清單。

觸發程序概觀

每個工作流程都包含觸發程式，其定義具現化和啟動工作流程的呼叫。以下是一般觸發程序類別：

輪詢觸發程序，用來定期檢查服務的端點
推送觸發程序，用來建立端點的訂閱，並提供回呼 URL，讓端點在指定的事件發生或資料可供使用時，可以通知觸發程序。然後，觸發程序會等到端點回應後才引發。

觸發程序具有下列最上層元素 (儘管有些是選用元素)：

"<trigger-name>": {
   "type": "<trigger-type>",
   "inputs": { "<trigger-inputs>" },
   "recurrence": { 
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>
   },
   "conditions": [ "<array-with-conditions>" ],
   "runtimeConfiguration": { "<runtime-config-options>" },
   "splitOn": "<splitOn-expression>",
   "operationOptions": "<operation-option>"
},

必要

值	類型	Description
<trigger-name>	String	觸發程序的名稱
<trigger-type>	String	觸發程序類型，例如 "Http" 或 "ApiConnection"
<trigger-inputs>	JSON 物件	定義觸發程序行為的輸入
<time-unit>	String	說明觸發程序多久引發一次的時間單位：[秒]、[分鐘]、[小時]、[天]、[週]、[月]
<number-of-time-units>	整數	一個值，指定觸發程序根據頻率多久會引發一次，這是觸發程序再次引發之前等待的時間單位數以下是最小和最大間隔： - 月：1-16 個月 - 日：1-500 天 - 小時：1-12，000 小時 - 分鐘：1-72，000 分鐘 - 秒：1-9，999，999 秒例如，如果間隔為 6，而頻率為 [月]，則週期為每 6 個月一次。

選擇性

值	類型	Description
<array-with-conditions>	Array	包含一或多個條件的陣列，這類條件會決定是否要執行工作流程。僅適用於觸發程序。
<runtime-config-options>	JSON 物件	您可以藉由設定 `runtimeConfiguration` 屬性來變更觸發程序執行階段行為。如需詳細資訊，請參閱執行階段組態設定。
<splitOn-expression>	String	針對會傳回陣列的觸發程序，您可以指定運算式，將陣列項目分割或解除批次為多個工作流程執行個體，以進行處理。
<operation-option>	String	您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

觸發程序類型清單

每一種觸發程序類型都有不同的介面，以及可定義觸發程序行為的輸入。

內建觸發程序

觸發程序類型	Description
HTTP	檢查或輪詢任何端點。此端點必須藉由使用`202`非同步模式或藉由傳回陣列，來遵守特定觸發合約。
HTTPWebhook	為您的邏輯應用程式建立可呼叫的端點，但會呼叫指定的 URL 以進行註冊或取消註冊。
週期性	根據已定義的排程來引發。您可以設定一個未來的日期和時間來引發此觸發程序。您也可以根據頻率來指定工作流程的執行時間和日期。
要求	為您的邏輯應用程式建立可呼叫的端點，也稱為「手動」觸發程序。例如，請參閱透過 HTTP 端點呼叫、觸發或巢狀處理工作流程。

受控 API 觸發程序

觸發程序類型	Description
ApiConnection	使用Microsoft 管理的 API 或「連接器」來檢查或輪詢端點。
ApiConnectionWebhook	藉由呼叫 Microsoft 管理的 API 或「連接器」來訂閱和取消訂閱，為您的邏輯應用程式工作流程建立可呼叫的端點。

觸發程序 - 詳細參考

APIConnection 觸發程序

此觸發程式會使用Microsoft 管理的 API 或「連接器」來檢查或輪詢端點，讓此觸發程式的參數會根據端點而有所不同。此觸發程序定義中的許多區段都是選用的。此觸發程序的行為取決於是否包含區段。

"<APIConnection_trigger_name>": {
   "type": "ApiConnection",
   "inputs": {
      "host": {
         "connection": {
            "name": "@parameters('$connections')['<connection-name>']['connectionId']"
         }
      },
      "method": "<method-type>",
      "path": "/<api-operation>",
      "retryPolicy": { "<retry-behavior>" },
      "queries": { "<query-parameters>" }
   },
   "recurrence": { 
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "splitOn": "<splitOn-expression>",
   "operationOptions": "<operation-option>"
}

必要

值	類型	Description
<APIConnection_trigger_name>	String	觸發程序的名稱
<connection-name>	String	工作流程所使用的受控 API 連線名稱
<method-type>	String	與受控 API 通訊時所使用的 HTTP 方法："GET"、"PUT"、"POST"、"PATCH"、"DELETE"
<api-operation>	String	要呼叫的 API 作業
<time-unit>	String	說明觸發程序多久引發一次的時間單位：[秒]、[分鐘]、[小時]、[天]、[週]、[月]
<number-of-time-units>	整數	一個值，指定觸發程序根據頻率多久會引發一次，這是觸發程序再次引發之前等待的時間單位數以下是最小和最大間隔： - 月：1-16 個月 - 日：1-500 天 - 小時：1-12，000 小時 - 分鐘：1-72，000 分鐘 - 秒：1-9，999，999 秒例如，如果間隔為 6，而頻率為 [月]，則週期為每 6 個月一次。

選擇性

值	類型	Description
<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
<query-parameters>	JSON 物件	要包含在 API 呼叫中的任何查詢參數。例如，`"queries": { "api-version": "2018-01-01" }` 物件會將 `?api-version=2018-01-01` 新增至呼叫。
<max-runs>	整數	根據預設，邏輯應用程式執行個體會以並行的方式同時執行，或依據預設限制以平行方式執行。若要藉由設定新的 <<count> 值>來變更此限制，請參閱變更觸發程序並行。
<max-runs-queue>	整數	當邏輯應用程式所執行的執行個體已達數目上限時 (您可以根據 `runtimeConfiguration.concurrency.runs` 屬性變更此限制)，任何新的執行都會放入此佇列中 (以預設限制為限)。若要變更預設限制，請參閱變更等候執行限制。
<splitOn-expression>	String	針對會傳回陣列的觸發程序，此運算式會參考要使用的陣列，讓您可以為每個陣列項目建立和執行工作流程執行個體，而非使用 "for each" 迴圈。例如，此運算式表示在觸發程序的主體內容中傳回的陣列項目：`@triggerbody()?['value']`
<operation-option>	String	您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

輸出

元素	類型	描述
headers	JSON 物件	回應中的標頭
body	JSON 物件	回應中的本文
狀態碼	整數	回應的狀態碼

範例

此觸發程序定義會每天在公司或學校帳戶的收件匣內檢查電子郵件：

"When_a_new_email_arrives": {
   "type": "ApiConnection",
   "inputs": {
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "method": "get",
      "path": "/Mail/OnNewEmail",
      "queries": {
          "fetchOnlyWithAttachment": false,
          "folderPath": "Inbox",
          "importance": "Any",
          "includeAttachments": false
      }
   },
   "recurrence": {
      "frequency": "Day",
      "interval": 1
   }
}

ApiConnectionWebhook 觸發程序

此觸發程序會使用 Microsoft 管理的 API 將訂閱要求傳送至端點、提供可讓端點傳送回應的回呼 URL，並等候端點回應。如需詳細資訊，請參閱端點訂閱。

"<ApiConnectionWebhook_trigger_name>": {
   "type": "ApiConnectionWebhook",
   "inputs": {
      "body": {
          "NotificationUrl": "@{listCallbackUrl()}"
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['<connection-name>']['connectionId']"
         }
      },
      "retryPolicy": { "<retry-behavior>" },
      "queries": "<query-parameters>"
   },
   "runTimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-run-queue>
      }
   },
   "splitOn": "<splitOn-expression>",
   "operationOptions": "<operation-option>"
}

必要

值	類型	Description
<connection-name>	String	工作流程所使用的受控 API 連線名稱
<body-content>	JSON 物件	任何要以承載的形式傳送至受控 API 的訊息內容

選擇性

值	類型	Description
<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
<query-parameters>	JSON 物件	要包含在 API 呼叫中的任何查詢參數例如，`"queries": { "api-version": "2018-01-01" }` 物件會將 `?api-version=2018-01-01` 新增至呼叫。
<max-runs>	整數	根據預設，邏輯應用程式執行個體會以並行的方式同時執行，或依據預設限制以平行方式執行。若要藉由設定新的 <<count> 值>來變更此限制，請參閱變更觸發程序並行。
<max-runs-queue>	整數	當邏輯應用程式所執行的執行個體已達數目上限時 (您可以根據 `runtimeConfiguration.concurrency.runs` 屬性變更此限制)，任何新的執行都會放入此佇列中 (以預設限制為限)。若要變更預設限制，請參閱變更等候執行限制。
<splitOn-expression>	String	針對會傳回陣列的觸發程序，此運算式會參考要使用的陣列，讓您可以為每個陣列項目建立和執行工作流程執行個體，而非使用 "for each" 迴圈。例如，此運算式表示在觸發程序的主體內容中傳回的陣列項目：`@triggerbody()?['value']`
<operation-option>	String	您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

範例

此觸發程序定義會訂閱 Office 365 Outlook API、提供 API 端點的回呼 URL，並在新的電子郵件送達時等候端點回應。

"When_a_new_email_arrives_(webhook)": {
   "type": "ApiConnectionWebhook",
   "inputs": {
      "body": {
         "NotificationUrl": "@{listCallbackUrl()}" 
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "path": "/MailSubscription/$subscriptions",
      "queries": {
          "folderPath": "Inbox",
          "hasAttachment": "Any",
          "importance": "Any"
      }
   },
   "splitOn": "@triggerBody()?['value']"
}

HTTP 觸發程序

此觸發程式會根據指定的週期排程，將要求傳送至指定的 HTTP 或 HTTPS 端點。觸發程式接著會檢查回應，以判斷工作流程是否執行。如需更多資訊，請參閱從 Azure Logic Apps 透過 HTTP 或 HTTPS 呼叫服務端點。

"HTTP": {
   "type": "Http",
   "inputs": {
      "method": "<method-type>",
      "uri": "<HTTP-or-HTTPS-endpoint-URL>",
      "headers": { "<header-content>" },
      "queries": "<query-parameters>",
      "body": "<body-content>",
      "authentication": { "<authentication-type-and-property-values>" },
      "retryPolicy": {
         "type": "<retry-behavior>"
      }
   },
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "operationOptions": "<operation-option>"
}

必要

屬性	值	類型	Description
`method`	<method-type>	String	用來傳送要求的方法："GET"、"PUT"、"POST"、"PATCH" 或 "DELETE"
`uri`	<HTTP-or-HTTPS-endpoint-URL>	String	您想要傳送傳出要求的 HTTP 或 HTTPS 端點 URL。字串大小上限：2 KB 對於 Azure 服務或資源，此 URI 語法包含資源識別碼和您想要存取之資源的路徑。
`frequency`	<time-unit>	String	說明觸發程序多久引發一次的時間單位：[秒]、[分鐘]、[小時]、[天]、[週]、[月]
`interval`	<number-of-time-units>	整數	一個值，指定觸發程序根據頻率多久會引發一次，這是觸發程序再次引發之前等待的時間單位數以下是最小和最大間隔： - 月：1-16 個月 - 日：1-500 天 - 小時：1-12，000 小時 - 分鐘：1-72，000 分鐘 - 秒：1-9，999，999 秒例如，如果間隔為 6，而頻率為 [月]，則週期為每 6 個月一次。

選擇性

屬性	值	類型	Description
`headers`	<header-content>	JSON 物件	您需要與要求一起包含的任何標頭例如，若要設定語言和類型︰ `"headers": { "Accept-Language": "en-us", "Content-Type": "application/json" }`
`queries`	<query-parameters>	JSON 物件	您需要在要求中使用的任何查詢參數例如，`"queries": { "api-version": "2018-01-01" }` 物件會將 `?api-version=2018-01-01` 新增至要求。
`body`	<body-content>	JSON 物件	要以承載的形式透過要求傳送的訊息內容
`authentication`	<authentication-type-and-property-values>	JSON 物件	要求用於驗證輸出要求的驗證模型。如需詳細資訊，請參閱對於輸出驗證新增驗證。除了排程器之外，還可支援 `authority` 屬性。若未指定，預設值為 `https://management.azure.com/`，但您可以使用不同的值。
`retryPolicy` > `type`	<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
`runs`	<max-runs>	整數	根據預設，邏輯應用程式執行個體會以並行的方式同時執行，或依據預設限制以平行方式執行。若要藉由設定新的 <<count> 值>來變更此限制，請參閱變更觸發程序並行。
`maximumWaitingRuns`	<max-runs-queue>	整數	當邏輯應用程式所執行的執行個體已達數目上限時 (您可以根據 `runtimeConfiguration.concurrency.runs` 屬性變更此限制)，任何新的執行都會放入此佇列中 (以預設限制為限)。若要變更預設限制，請參閱變更等候執行限制。
`operationOptions`	<operation-option>	String	您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

輸出

元素	類型	Description
`headers`	JSON 物件	回應中的標頭
`body`	JSON 物件	回應中的本文
`status code`	整數	回應的狀態碼

連入要求的需求

若要與邏輯應用程式妥善搭配運作，端點必須符合特定的觸發模式或合約，並辨識下列屬性：

屬性	必要	Description
狀態碼	Yes	「200 正常」狀態碼會啟動執行。其他任何的狀態碼則不會啟動執行。
Retry-after 標頭	No	邏輯應用程式再次輪詢端點前所需經過的秒數
位置標頭	No	在下一個輪詢間隔時所要呼叫的 URL。如果未指定，則會使用原本的 URL。

不同要求的範例行為

狀態碼	多久之後重試	行為
200	{無}	執行工作流程，然後在所定義的週期之後再次檢查是否有其他資料。
200	10 秒	執行工作流程，然後在 10 秒之後再次檢查是否有其他資料。
202	60 秒	不觸發工作流程。下一次嘗試會依據所定義的週期，在一分鐘內開始。如果所定義的週期不超過一分鐘，則 retry-after 標頭的優先順序較高。否則會採用所定義的週期。
400	{無}	不正確的要求，不執行工作流程。如果未定義任何 `retryPolicy`，則會使用預設原則。達到重試次數之後，觸發程序會在所定義的週期之後再次檢查是否還有資料。
500	{無}	伺服器錯誤，不執行工作流程。如果未定義任何 `retryPolicy`，則會使用預設原則。達到重試次數之後，觸發程序會在所定義的週期之後再次檢查是否還有資料。

HTTPWebhook 觸發程序

此觸發程序會建立可藉由呼叫指定的端點 URL 來註冊訂閱的端點，讓您的邏輯應用程式可供呼叫。當您在工作流程中建立此觸發程序時，連出要求將會使呼叫註冊訂閱。如此，觸發程序即可開始接聽事件。若有作業使這個觸發程序失效，連出要求即會自動使呼叫取消訂閱。如需詳細資訊，請參閱端點訂閱。

您也可以指定 HTTPWebhook 觸發程序的非同步限制。此觸發程序的行為取決於您所使用或省略的區段。

"HTTP_Webhook": {
   "type": "HttpWebhook",
   "inputs": {
      "subscribe": {
         "method": "<method-type>",
         "uri": "<endpoint-subscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" },
         "retryPolicy": { "<retry-behavior>" }
         },
      },
      "unsubscribe": {
         "method": "<method-type>",
         "url": "<endpoint-unsubscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" }
      }
   },
   "runTimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "operationOptions": "<operation-option>"
}

某些值 (例如 <<method-type>)> 同時適用於 "subscribe" 和 "unsubscribe" 物件。

必要

值	類型	Description
<method-type>	String	用於訂閱要求的 HTTP 方法："GET"、"PUT"、"POST"、"PATCH" 或 "DELETE"
<endpoint-subscribe-URL>	String	要傳送訂閱要求的目標端點 URL

選擇性

值	類型	Description
<method-type>	String	用於取消要求的 HTTP 方法："GET"、"PUT"、"POST"、"PATCH" 或 "DELETE"
<endpoint-unsubscribe-URL>	String	要傳送取消要求的目標端點 URL
<body-content>	String	要在訂閱或取消要求中傳送的任何訊息內容
<authentication-type>	JSON 物件	要求用於驗證輸出要求的驗證模型。如需詳細資訊，請參閱對於輸出驗證新增驗證。
<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
<max-runs>	整數	根據預設，邏輯應用程式執行個體會以並行的方式同時執行，或依據預設限制以平行方式執行。若要藉由設定新的 <<count> 值>來變更此限制，請參閱變更觸發程序並行。
<max-runs-queue>	整數	當邏輯應用程式所執行的執行個體已達數目上限時 (您可以根據 `runtimeConfiguration.concurrency.runs` 屬性變更此限制)，任何新的執行都會放入此佇列中 (以預設限制為限)。若要變更預設限制，請參閱變更等候執行限制。
<operation-option>	String	您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

輸出

元素	類型	描述
headers	JSON 物件	回應中的標頭
body	JSON 物件	回應中的本文
狀態碼	整數	回應的狀態碼

範例

此觸發程序會建立對指定端點的訂閱、提供唯一回呼 URL，並等候新發佈的技術文章。

"HTTP_Webhook": {
   "type": "HttpWebhook",
   "inputs": {
      "subscribe": {
         "method": "POST",
         "uri": "https://pubsubhubbub.appspot.com/subscribe",
         "body": {
            "hub.callback": "@{listCallbackUrl()}",
            "hub.mode": "subscribe",
            "hub.topic": "https://pubsubhubbub.appspot.com/articleCategories/technology"
         },
      },
      "unsubscribe": {
         "method": "POST",
         "url": "https://pubsubhubbub.appspot.com/subscribe",
         "body": {
            "hub.callback": "@{workflow().endpoint}@{listCallbackUrl()}",
            "hub.mode": "unsubscribe",
            "hub.topic": "https://pubsubhubbub.appspot.com/articleCategories/technology"
         }
      }
   }
}

循環觸發程序

此觸發程序會根據指定的週期排程來執行，並提供建立定期執行工作流程的簡單方式。

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
      "startTime": "<start-date-time-with-format-YYYY-MM-DDThh:mm:ss>",
      "timeZone": "<time-zone>",
      "schedule": {
         // Applies only when frequency is Day or Week. Separate values with commas.
         "hours": [ <one-or-more-hour-marks> ], 
         // Applies only when frequency is Day or Week. Separate values with commas.
         "minutes": [ <one-or-more-minute-marks> ], 
         // Applies only when frequency is Week. Separate values with commas.
         "weekDays": [ "Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday" ] 
      }
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-runs-queue>
      }
   },
   "operationOptions": "<operation-option>"
}

必要

值	類型	Description
<time-unit>	String	說明觸發程序多久引發一次的時間單位：[秒]、[分鐘]、[小時]、[天]、[週]、[月]
<number-of-time-units>	整數	一個值，指定觸發程序根據頻率多久會引發一次，這是觸發程序再次引發之前等待的時間單位數以下是最小和最大間隔： - 月：1-16 個月 - 日：1-500 天 - 小時：1-12，000 小時 - 分鐘：1-72，000 分鐘 - 秒：1-9，999，999 秒例如，如果間隔為 6，而頻率為 [月]，則週期為每 6 個月一次。

值

類型

Description

<time-unit>

String

說明觸發程序多久引發一次的時間單位：[秒]、[分鐘]、[小時]、[天]、[週]、[月]

<number-of-time-units>

整數

一個值，指定觸發程序根據頻率多久會引發一次，這是觸發程序再次引發之前等待的時間單位數

以下是最小和最大間隔：

- 月：1-16 個月
- 日：1-500 天
- 小時：1-12，000 小時
- 分鐘：1-72，000 分鐘
- 秒：1-9，999，999 秒

例如，如果間隔為 6，而頻率為 [月]，則週期為每 6 個月一次。

選擇性

值	類型	Description
<start-date-time-with-format-YYYY-MM-DDThh:mm:ss>	String	使用以下格式的開始日期和時間： YYYY-MM-DDThh:mm:ss (如果您指定時區) -或- YYYY-MM-DDThh:mm:ssZ (如果您未指定時區) 因此，舉例來說，如果您想要的是 2017 年 9 月 18 日下午 2:00，則請指定 "2017-09-18T14:00:00"，然後指定一個時區，例如 "Pacific Standard Time"，或指定不含時區的 "2017-09-18T14:00:00Z"。注意：這個開始時間最多為 49 年且必須依照 UTC 日期時間格式中的 ISO 8601 日期時間規格，但不含 UTC 時差。如果您不指定時區，就必須在結尾加上字母 "Z"，其中不含任何空格。這個 "Z" 係指對等的航海時間。就簡單排程來說，開始時間係指第一次發生的時間，而就複雜排程來說，觸發程序會在開始時間一到就立即引發。如需有關開始日期和時間的詳細資訊，請參閱建立及排定定期執行的工作。
<time-zone>	String	只有當您有指定開始時間時才適用，因為此觸發程序並不接受 UTC 時差。指定您要套用的時區。
<one-or-more-hour-marks>	整數或整數陣列	當您想要執行工作流程時，如果針對 `frequency` 指定 "Day" 或 "Week"，便可指定從 0 到 23 的一或多個整數 (以逗號分隔) 來表示一天中的哪幾個整點。例如，如果您指定 "10"、"12" 及 "14"，就會得出上午 10 點、下午 12 點及下午 2 點作為整點標記。
<one-or-more-minute-marks>	整數或整數陣列	當您想要執行工作流程時，如果針對 `frequency` 指定 "Day" 或 "Week"，便可指定從 0 到 59 的一或多個整數 (以逗號分隔) 來表示小時中的哪幾個分鐘。例如，您可以指定 "30" 作為分鐘標記，然後使用上個範例代表一天中的整點，這樣就會得出上午 10:30、下午 12:30 及下午 2:30。
weekDays	字串或字串陣列	當您想要執行工作流程時，如果針對 `frequency` 指定 "Week"，便可指定一或多天 (以逗號分隔)："Monday"、"Tuesday"、"Wednesday"、"Thursday"、"Friday"、"Saturday" 及 "Sunday"
<max-runs>	整數	根據預設，邏輯應用程式執行個體會以並行的方式同時執行，或依據預設限制以平行方式執行。若要藉由設定新的 <<count> 值>來變更此限制，請參閱變更觸發程序並行。
<max-runs-queue>	整數	當邏輯應用程式所執行的執行個體已達數目上限時 (您可以根據 `runtimeConfiguration.concurrency.runs` 屬性變更此限制)，任何新的執行都會放入此佇列中 (以預設限制為限)。若要變更預設限制，請參閱變更等候執行限制。
<operation-option>	String	您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

範例 1

這個基本週期觸發程序會每天執行：

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Day",
      "interval": 1
   }
}

範例 2

您可以指定開始日期和時間來引發觸發程序。此週期觸發程序會於指定的日期開始，然後每天引發：

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Day",
      "interval": 1,
      "startTime": "2017-09-18T00:00:00Z"
   }
}

範例 3

此週期觸發程序會於 2017 年 9 月 9 日下午 2:00 開始，在每週星期一早上 10:30、下午 12:30 及下午 2:30 (太平洋標準時間) 引發：

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Week",
      "interval": 1,
      "schedule": {
         "hours": [ 10, 12, 14 ],
         "minutes": [ 30 ],
         "weekDays": [ "Monday" ]
      },
      "startTime": "2017-09-07T14:00:00",
      "timeZone": "Pacific Standard Time"
   }
}

如需此觸發程序外加範例的詳細資訊，請參閱建立及排定定期執行的工作。

要求觸發程序

此觸發程序會藉由建立可接受連入要求的端點，讓您的邏輯應用程式可供呼叫。針對此觸發程序，請提供 JSON 結構描述，用以說明及驗證承載，或觸發程序從連入要求接收的輸入。此結構描述也可讓工作流程中的後續動作更容易參考觸發程序屬性。

若要呼叫此觸發程序，您必須使用工作流程服務 REST API 中說明的 listCallbackUrl API。若要了解如何使用這個觸發程序作為 HTTP 端點，請參閱透過 HTTP 端點呼叫、觸發或巢狀處理工作流程。

"manual": {
   "type": "Request",
   "kind": "Http",
   "inputs": {
      "method": "<method-type>",
      "relativePath": "<relative-path-for-accepted-parameter>",
      "schema": {
         "type": "object",
         "properties": { 
            "<property-name>": {
               "type": "<property-type>"
            }
         },
         "required": [ "<required-properties>" ]
      }
   },
   "runTimeConfiguration": {
      "concurrency": {
         "runs": <max-runs>,
         "maximumWaitingRuns": <max-run-queue>
      },
   },
   "operationOptions": "<operation-option>"
}

必要

值	類型	Description
<property-name>	String	JSON 結構描述中的屬性名稱，用以說明承載
<property-type>	String	屬性的類型

選擇性

值	類型	Description
<method-type>	String	連入要求呼叫您的邏輯應用程式時所必須使用的方法："GET"、"PUT"、"POST"、"PATCH"、"DELETE"
<relative-path-for-accepted-parameter>	String	端點 URL 可接受的參數相對路徑
<required-properties>	Array	需要值的一或多個屬性
<max-runs>	整數	根據預設，邏輯應用程式執行個體會以並行的方式同時執行，或依據預設限制以平行方式執行。若要藉由設定新的 <<count> 值>來變更此限制，請參閱變更觸發程序並行。
<max-runs-queue>	整數	當邏輯應用程式所執行的執行個體已達數目上限時 (您可以根據 `runtimeConfiguration.concurrency.runs` 屬性變更此限制)，任何新的執行都會放入此佇列中 (以預設限制為限)。若要變更預設限制，請參閱變更等候執行限制。
<operation-option>	String	您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

範例

此觸發程序會指定連入要求必須使用 HTTP POST 方法來呼叫觸發程序，並且包含結構描述可驗證來自連入要求的輸入：

"manual": {
   "type": "Request",
   "kind": "Http",
   "inputs": {
      "method": "POST",
      "schema": {
         "type": "object",
         "properties": {
            "customerName": {
               "type": "String"
            },
            "customerAddress": { 
               "type": "Object",
               "properties": {
                  "streetAddress": {
                     "type": "string"
                  },
                  "city": {
                     "type": "string"
                  }
               }
            }
         }
      }
   }
}

觸發條件

對於任何觸發程序且僅限觸發程序，您可以加入含有一或多個條件運算式以用來決定是否應執行工作流程的陣列。若要將 conditions 屬性新增至您邏輯應用程式中的觸發程序，請在程式碼檢視編輯器中開啟邏輯應用程式。

例如，您可以指定要藉由參考觸發程序在 conditions 屬性中的狀態碼，而僅在網站傳回內部伺服器錯誤時引發觸發程序：

"Recurrence": {
   "type": "Recurrence",
   "recurrence": {
      "frequency": "Hour",
      "interval": 1
   },
   "conditions": [ {
      "expression": "@equals(triggers().code, 'InternalServerError')"
   } ]
}

根據預設，觸發程序只會在收到「200 確定」回應時引發。當運算式參考觸發程序的狀態碼時，就會取代觸發程序的預設行為。因此，如果您要針對多個狀態碼 (例如狀態碼 "200" 和 "201") 來引發觸發程序，您必須將此運算式納入您的條件中：

@or(equals(triggers().code, 200),equals(triggers().code, 201))

在陣列上觸發多個執行程序

若觸發程序接收要讓工作流程進行的陣列，有時候 "for each" 迴圈可能會耗費多時處理每個陣列項目。您可以改用觸發程序中的 SplitOn 屬性來對該陣列進行「解除批次」。解除批次會分割陣列項目，並啟動新邏輯應用程式執行個體，讓其針對每個陣列項目執行。例如，當您想要輪詢的端點可能在輪詢間隔之間傳回多個新項目時，就適用此方法。

若觸發程序的 Swagger 檔案說明承載表示陣列，則會將 SplitOn 屬性自動新增至您的觸發程序。否則，就要在其中有陣列需要解除批次的回應承載內，新增此屬性。

使用 SplitOn 功能之前，請先檢閱下列考量：

若觸發程序並行已開啟，則會大幅降低 SplitOn 限制。如果專案數目超過此限制，則會停用 SplitOn 功能。
您無法將 SplitOn 功能用於同步的回應模式。任何使用 SplitOn 屬性並包括回應動作的工作流程會以非同步的方式執行，而且立即傳送202 ACCEPTED回應。
如需 SplitOn 在單一工作流程執行中可處理最大數目的陣列項目，請參閱限制和設定。

範例

假設您有一個 HTTP 觸發程序，其會呼叫 API 並接收此回應：

{
   "Status": "Succeeded",
   "Rows": [ 
      { 
         "id": 938109380,
         "name": "customer-name-one"
      },
      {
         "id": 938109381,
         "name": "customer-name-two"
      }
   ]
}

您的工作流程只需要陣列中Rows所包括的內容，因此可以建立如下列範例所示的觸發程序：

"HTTP_Debatch": {
   "type": "Http",
    "inputs": {
        "uri": "https://mydomain.com/myAPI",
        "method": "GET"
    },
   "recurrence": {
      "frequency": "Second",
      "interval": 1
    },
    "splitOn": "@triggerBody()?.Rows"
}

注意

如果您使用 SplitOn 命令，就無法取得陣列外的屬性。因此針對此範例，您就無法在 API 傳回的回應中取得 status屬性。

為避免在 ? 屬性不存在時發生失敗，此範例使用了 Rows 運算子。

您的工作流程定義現在可以使用 @triggerBody().name 來取得 name 值；此值在第一個執行中為 "customer-name-one"，在第二個執行中為 "customer-name-two"。因此，觸發程序的輸出看起來就像下面這些範例︰

{
   "body": {
      "id": 938109380,
      "name": "customer-name-one"
   }
}

{
   "body": {
      "id": 938109381,
      "name": "customer-name-two"
   }
}

動作概觀

Azure Logic Apps 提供各種不同的動作類型 - 各有不同的輸入會定義動作的獨特行為。動作具有下列高階元素 (儘管有些是選用元素)：

"<action-name>": {
   "type": "<action-type>",
   "inputs": { 
      "<input-name>": { "<input-value>" },
      "retryPolicy": "<retry-behavior>" 
   },
   "runAfter": { "<previous-trigger-or-action-status>" },
   "runtimeConfiguration": { "<runtime-config-options>" },
   "operationOptions": "<operation-option>"
},

必要

值	類型	Description
<action-name>	String	動作的名稱
<action-type>	String	動作類型，例如："Http" 或 "ApiConnection"
<input-name>	String	定義動作行為的輸入名稱
<input-value>	各種類型	輸入值，可以是字串、整數、JSON 物件等等
<previous-trigger-or-action-status>	JSON 物件	必須先行執行，這個現行動作才可隨即執行的觸發程序或動作所具備的名稱和產生的狀態

選擇性

值	類型	Description
<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
<runtime-config-options>	JSON 物件	對於某些動作，您可以在執行階段藉由設定 `runtimeConfiguration` 屬性來變更動作的行為。如需詳細資訊，請參閱執行階段組態設定。
<operation-option>	String	對於某些動作，您可以藉由設定 `operationOptions` 屬性來變更預設行為。如需詳細資訊，請參閱作業選項。

動作類型清單

以下是一些常用的動作類型：

內建動作類型，例如下列範例：
- HTTP，用以透過 HTTP 或 HTTPS 呼叫端點
- 回應，用以回應要求
- 執行 JavaScript 程式碼 以執行 JavaScript 代碼段
- 函式，用以呼叫 Azure Functions
- 資料作業動作，例如聯結、撰寫、資料表、選取，以及其他會建立資料或從各種不同的輸入轉換資料的動作
- 工作流程，用以呼叫另一個邏輯應用程式工作流程
受控 API 動作類型，例如會呼叫多種由 Microsoft 管理的連接器和 API (例如 Azure 服務匯流排、Office 365 Outlook、Power BI、Azure Blob 儲存體、OneDrive、GitHub 等) 的 ApiConnection 和 ApiConnectionWebHook
控制工作流程動作類型，例如 If、Foreach、Switch、Scope 和 Until，其中包含其他動作，並且可協助您組織工作流程執行

內建動作

動作類型	Description
組成	從可具有多種類型的輸入建立單一輸出。
執行 JavaScript 程式碼	執行符合特定準則的 JavaScript 程式碼片段。如需程式碼需求和詳細資訊，請參閱使用內嵌程式碼新增和執行程式碼片段。
函式	呼叫 Azure 函式。
HTTP	呼叫 HTTP 端點。
Join	從陣列中的所有項目建立字串，並使用指定的分隔字元來分隔這些項目。
剖析 JSON	從 JSON 內容中的屬性建立易記的權杖。其後，您可以在邏輯應用程式中納入權杖，以參考這些屬性。
查詢	根據條件或篩選條件，從另一個陣列中的項目建立陣列。
回應	建立對連入呼叫或要求的回應。
選取	根據指定的對應從另一個陣列中轉換項目，以使用 JSON 物件建立陣列。
資料表	從陣列建立 CSV 或 HTML 資料表。
終止	停止正在執行的工作流程。
Wait	將工作流程暫停指定的持續期間，或直到指定的日期和時間為止。
工作流程	將工作流程內嵌於另一個工作流程內。

受控 API 動作

動作類型	Description
ApiConnection	使用 Microsoft 管理的 API 來呼叫 HTTP 端點。
ApiConnectionWebhook	運作方式與 HTTPWebhook 類似，但使用 Microsoft 管理的 API。

控制工作流程動作

這些動作可協助您控制工作流程執行，且包含其他動作。在控制工作流程動作以外，您可以直接參考該控制工作流程動作內的動作。例如，如果您在範圍內有 Http 動作，則可以從工作流程中的任一處參考 @body('Http') 運算式。不過，存在於控制工作流程動作內的動作，就只能在相同控制工作流程結構中的其他動作「之後」執行。

動作類型	Description
ForEach	以迴圈對陣列中的每個項目執行相同的動作。
If	根據是否符合指定的條件來執行動作。
範圍	根據一組動作的群組狀態來執行動作。
交換器	在運算式、物件或權杖中的值符合各個案例所指定的值時，執行組織為案例的動作。
Until	以迴圈執行動作，直到符合指定的條件為止。

動作 - 詳細參考

APIConnection 動作

此動作會將 HTTP 要求傳送至 Microsoft 管理的 API，因此需要 API 和參數的相關資訊，以及有效連線的參考。

"<action-name>": {
   "type": "ApiConnection",
   "inputs": {
      "host": {
         "connection": {
            "name": "@parameters('$connections')['<api-name>']['connectionId']"
         },
         "<other-action-specific-input-properties>"        
      },
      "method": "<method-type>",
      "path": "/<api-operation>",
      "retryPolicy": "<retry-behavior>",
      "queries": { "<query-parameters>" },
      "<other-action-specific-properties>"
    },
    "runAfter": {}
}

必要

值	類型	Description
<action-name>	String	連接器所提供的動作名稱
<api-name>	String	由 Microsoft 管理、用於連線的 API 名稱
<method-type>	String	呼叫 API 的 HTTP 方法："GET"、"PUT"、"POST"、"PATCH" 或 "DELETE"
<api-operation>	String	要呼叫的 API 作業

選擇性

值	類型	Description
<other-action-specific-input-properties>	JSON 物件	任何其他套用至這個特定動作的輸入屬性
<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
<query-parameters>	JSON 物件	要包含在 API 呼叫中的任何查詢參數。例如，`"queries": { "api-version": "2018-01-01" }` 物件會將 `?api-version=2018-01-01` 新增至呼叫。
<other-action-specific-properties>	JSON 物件	任何其他套用至這個特定動作的屬性

範例

此定義會說明 Office 365 Outlook 連接器 (此為 Microsoft 管理的 API) 的傳送電子郵件動作：

"Send_an_email": {
   "type": "ApiConnection",
   "inputs": {
      "body": {
         "Body": "Thank you for your membership!",
         "Subject": "Hello and welcome!",
         "To": "Sophie.Owen@contoso.com"
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "method": "POST",
      "path": "/Mail"
    },
    "runAfter": {}
}

APIConnectionWebhook 動作

此動作會使用 Microsoft 管理的 API 透過 HTTP 將訂閱要求傳送至端點、提供可讓端點傳送回應的回呼 URL，並等候端點回應。如需詳細資訊，請參閱端點訂閱。

"<action-name>": {
   "type": "ApiConnectionWebhook",
   "inputs": {
      "subscribe": {
         "method": "<method-type>",
         "uri": "<api-subscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" },
         "retryPolicy": "<retry-behavior>",
         "queries": { "<query-parameters>" },
         "<other-action-specific-input-properties>"
      },
      "unsubscribe": {
         "method": "<method-type>",
         "uri": "<api-unsubscribe-URL>",
         "headers": { "<header-content>" },
         "body": "<body-content>",
         "authentication": { "<authentication-type>" },
         "<other-action-specific-properties>"
      },
   },
   "runAfter": {}
}

某些值 (例如 <<method-type>)> 同時適用於 "subscribe" 和 "unsubscribe" 物件。

必要

值	類型	Description
<action-name>	String	連接器所提供的動作名稱
<method-type>	String	用來訂閱或取消訂閱端點的 HTTP 方法："GET"、"PUT"、"POST"、"PATCH" 或 "DELETE"
<api-subscribe-URL>	String	用來訂閱 API 的 URI

選擇性

值	類型	Description
<api-unsubscribe-URL>	String	用來取消訂閱 API 的 URI
<header-content>	JSON 物件	要在要求中傳送的任何標頭例如，若要對要求設定語言和類型︰ `"headers": { "Accept-Language": "en-us", "Content-Type": "application/json" }`
<body-content>	JSON 物件	要在要求中傳送的任何訊息內容
<authentication-type>	JSON 物件	要求用於驗證輸出要求的驗證模型。如需詳細資訊，請參閱對於輸出驗證新增驗證。
<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
<query-parameters>	JSON 物件	要包含在 API 呼叫中的任何查詢參數例如，`"queries": { "api-version": "2018-01-01" }` 物件會將 `?api-version=2018-01-01` 新增至呼叫。
<other-action-specific-input-properties>	JSON 物件	任何其他套用至這個特定動作的輸入屬性
<other-action-specific-properties>	JSON 物件	任何其他套用至這個特定動作的屬性

您也可以採用與 HTTP 非同步限制相同的方式，指定對 ApiConnectionWebhook 動作的限制。

撰寫動作

此動作會從多個輸入 (包括運算式) 建立單一輸出。輸出和輸入都具有 Azure Logic Apps 原生支援的任何類型，例如陣列、JSON 物件、XML 和二進位檔。其後，您可以在其他動作中使用該動作的輸出。

"Compose": {
   "type": "Compose",
   "inputs": "<inputs-to-compose>",
   "runAfter": {}
},

必要

值	類型	Description
<inputs-to-compose>	任意	用來建立單一輸出的輸入

範例 1

此動作定義會合併 abcdefg 與尾端空格和值 1234：

"Compose": {
   "type": "Compose",
   "inputs": "abcdefg 1234",
   "runAfter": {}
},

以下是此動作建立的輸出：

abcdefg 1234

範例 2

此動作定義會合併包含 abcdefg 的字串變數與包含 1234 的整數變數：

"Compose": {
   "type": "Compose",
   "inputs": "@{variables('myString')}@{variables('myInteger')}",
   "runAfter": {}
},

以下是此動作建立的輸出：

"abcdefg1234"

執行 JavaScript 程式碼動作

此動作會執行 JavaScript 程式碼片段，並透過權杖傳回結果，該權杖後續在工作流程中的動作可以參考。

"Execute_JavaScript_Code": {
   "type": "JavaScriptCode",
   "inputs": {
      "code": "<JavaScript-code-snippet>",
      "explicitDependencies": {
         "actions": [ <preceding-actions> ],
         "includeTrigger": true
      }
   },
   "runAfter": {}
}

必要

值	類型	Description
<JavaScript-code-snippet>	不定	您要執行的 JavaScript 程式碼。如需程式碼需求和詳細資訊，請參閱在工作流程中執行程式碼片段。在屬性中 `code` ，您的程式碼片段可以使用唯讀 `workflowContext` 物件做為輸入。此物件包含子屬性，可讓您的程式碼存取觸發程序的輸出和工作流程中任何先前動作的結果。如需 `workflowContext` 物件的詳細資訊，請參閱使用 workflowContext 物件來參考觸發程序和動作結果。

在某些情況下需要

屬性 explicitDependencies 指定您想要明確包含觸發程式、先前動作的結果，或兩者都是程式碼片段的相依性。如需新增這些相依性的詳細資訊，請參閱將相依性新增為內嵌程式碼動作的參數。

includeTrigger針對屬性，您可以指定 true 或 false 值。

值	類型	描述
<preceding-actions>	字串陣列	此陣列具有 JSON 格式的動作名稱，且以此做為相依性。請務必使用工作流程定義中顯示的動作名稱，其中動作名稱使用底線 (「_」)，而不是空格 (「」)。

範例 1

此動作會執行程式碼，以取得邏輯應用程式工作流程的名稱，並傳回結果為「Hello world from < logic-app-name >」的文字。在此範例中，程式碼會透過唯讀 workflowContext.workflow.name 物件存取 workflowContext 屬性，以參考工作流程的名稱。如需使用workflowContext物件的詳細資訊，請參閱程式碼中的參考觸發程序和動作結果。

"Execute_JavaScript_Code": {
   "type": "JavaScriptCode",
   "inputs": {
      "code": "var text = \"Hello world from \" + workflowContext.workflow.name;\r\n\r\nreturn text;"
   },
   "runAfter": {}
}

範例 2

此動作會在邏輯應用程式工作流程中執行程式碼，以在新的電子郵件送達 Outlook 帳戶時觸發。此工作流程也會使用 Office 365 Outlook 的傳送核准電子郵件動作，從收到的電子郵件轉送內容以及核准要求。

程式碼會從電子郵件訊息的 Body 屬性擷取電子郵件地址，並從核准動作傳回地址以及 SelectedOption 屬性值。此動作會明確包含傳送核准電子郵件動作做為 explicitDependencies 物件中 actions 物件的相依性。

"Execute_JavaScript_Code": {
   "type": "JavaScriptCode",
   "inputs": {
      "code": "var myResult = /(([^<>()\\[\\]\\\\.,;:\\s@\"]+(\\.[^<>()\\[\\]\\\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))/g;\r\n\r\nvar email = workflowContext.trigger.outputs.body.Body;\r\n\r\nvar reply = workflowContext.actions.Send_approval_email.outputs.body.SelectedOption;\r\n\r\nreturn email.match(myResult) + \" - \" + reply;\r\n;",
      "explicitDependencies": {
         "actions": [
            "Send_approval_email"
         ]
      }
   },
   "runAfter": {}
}

函式動作

此動作會呼叫先前建立的 Azure 函式。

"<Azure-function-name>": {
   "type": "Function",
   "inputs": {
     "function": {
        "id": "<Azure-function-ID>"
      },
      "method": "<method-type>",
      "headers": { "<header-content>" },
      "body": { "<body-content>" },
      "queries": { "<query-parameters>" } 
   },
   "runAfter": {}
}

必要

值	類型	Description
<Azure-function-ID>	String	您想要呼叫的 Azure 函式所具備的資源識別碼。此值的格式如下： "/subscriptions/<<Azure-subscription-ID>>/resourceGroups/<>/providers/Microsoft.Web/sites/<>/functions/<>"
<method-type>	String	用來呼叫函式的 HTTP 方法："GET"、"PUT"、"POST"、"PATCH" 或 "DELETE" 若未指定，預設方法將是 "POST"。

選擇性

值	類型	Description
<header-content>	JSON 物件	要透過呼叫傳送的任何標頭例如，若要對要求設定語言和類型︰ `"headers": { "Accept-Language": "en-us", "Content-Type": "application/json" }`
<body-content>	JSON 物件	要在要求中傳送的任何訊息內容
<query-parameters>	JSON 物件	要包含在 API 呼叫中的任何查詢參數例如，`"queries": { "api-version": "2018-01-01" }` 物件會將 `?api-version=2018-01-01` 新增至呼叫。
<other-action-specific-input-properties>	JSON 物件	任何其他套用至這個特定動作的輸入屬性
<other-action-specific-properties>	JSON 物件	任何其他套用至這個特定動作的屬性

當您儲存邏輯應用程式時，Logic Apps 引擎會對所參考的函式執行下列檢查︰

您的工作流程必須能夠存取該函式。
您的工作流程只能使用標準 HTTP 觸發程序或一般 JSON Webhook 觸發程序。

Logic Apps 引擎會取得及快取在執行階段上使用的觸發程序 URL。不過，若有任何作業讓快取的 URL 失效，函式動作就會在執行階段失敗。若要解決此問題，請再次儲存邏輯應用程式，讓邏輯應用程式再次取得及快取觸發程序 URL。
函式不可以有任何已定義的路由。
只允許使用「函式」和「匿名」授權層級。

範例

此動作定義會呼叫先前建立的 "GetProductID" 函式：

"GetProductID": {
   "type": "Function",
   "inputs": {
     "function": {
        "id": "/subscriptions/<XXXXXXXXXXXXXXXXXXXX>/resourceGroups/myLogicAppResourceGroup/providers/Microsoft.Web/sites/InventoryChecker/functions/GetProductID"
      },
      "method": "POST",
      "headers": { 
          "x-ms-date": "@utcnow()"
       },
      "body": { 
          "Product_ID": "@variables('ProductID')"
      }
   },
   "runAfter": {}
}

HTTP 動作

此動作會將要求傳送至指定的端點並檢查回應，以決定是否應執行工作流程。如需更多資訊，請參閱從 Azure Logic Apps 透過 HTTP 或 HTTPS 呼叫服務端點。

"HTTP": {
   "type": "Http",
   "inputs": {
      "method": "<method-type>",
      "uri": "<HTTP-or-HTTPS-endpoint-URL>",
      "headers": { "<header-content>" },
      "queries": { "<query-parameters>" },
      "body": "<body-content>",
      "authentication": { "<authentication-type-and-property-values>" },
      "retryPolicy": {
         "type": "<retry-behavior>"
      },
   },
   "runAfter": {}
}

必要

屬性	值	類型	Description
`method`	<method-type>	String	用來傳送要求的方法："GET"、"PUT"、"POST"、"PATCH" 或 "DELETE"
`uri`	<HTTP-or-HTTPS-endpoint-URL>	String	您想要傳送傳出要求的 HTTP 或 HTTPS 端點 URL。字串大小上限：2 KB 對於 Azure 服務或資源，此 URI 語法包含資源識別碼和您想要存取之資源的路徑。

選擇性

屬性	值	類型	Description
`headers`	<header-content>	JSON 物件	您需要與要求一起包含的任何標頭例如，若要設定語言和類型︰ `"headers": { "Accept-Language": "en-us", "Content-Type": "application/json" }`
`queries`	<query-parameters>	JSON 物件	您需要在要求中使用的任何查詢參數例如，`"queries": { "api-version": "2018-01-01" }` 物件會將 `?api-version=2018-01-01` 新增至呼叫。
`body`	<body-content>	JSON 物件	要以承載的形式透過要求傳送的訊息內容
`authentication`	<authentication-type-and-property-values>	JSON 物件	要求用於驗證輸出要求的驗證模型。如需詳細資訊，請參閱對於輸出驗證新增驗證。除了排程器之外，還可支援 `authority` 屬性。若未指定，預設值為 `https://management.azure.com/`，但您可以使用不同的值。
`retryPolicy` > `type`	<retry-behavior>	JSON 物件	自訂間歇性失敗 (狀態碼為 408、429 和 5XX) 和任何連線例外狀況的重試行為。如需詳細資訊，請參閱重試原則。
<other-action-specific-input-properties>	<input-property>	JSON 物件	任何其他套用至這個特定動作的輸入屬性
<other-action-specific-properties>	<property-value>	JSON 物件	任何其他套用至這個特定動作的屬性

範例

此動作定義會將要求傳送至指定的端點，以取得最新消息：

"HTTP": {
   "type": "Http",
   "inputs": {
      "method": "GET",
      "uri": "https://mynews.example.com/latest"
   }
}

聯結動作

此動作會從陣列中的所有項目建立字串，並使用指定的分隔字元來分隔這些項目。

"Join": {
   "type": "Join",
   "inputs": {
      "from": <array>,
      "joinWith": "<delimiter>"
   },
   "runAfter": {}
}

必要

值	類型	描述
<array>	Array	提供來源項目的陣列或運算式。如果您指定運算式，請以雙引號括住該運算式。
<delimiter>	單一字元字串	分隔字串中各個項目的字元

範例

假設您有先前建立的 "myIntegerArray" 變數，且其中包含下列整數陣列：

[1,2,3,4]

此動作定義會在運算式中使用 variables() 函式以取得變數中的值，並使用這些值建立此字串 (以逗號分隔)："1,2,3,4"

"Join": {
   "type": "Join",
   "inputs": {
      "from": "@variables('myIntegerArray')",
      "joinWith": ","
   },
   "runAfter": {}
}

剖析 JSON 動作

此動作會從 JSON 內容中的屬性建立易記的欄位或權杖。其後，您可以在邏輯應用程式中改用權杖，以存取這些屬性。例如，如果您想要使用 Azure 服務匯流排和 Azure Cosmos DB 等服務的 JSON 輸出，您可以在邏輯應用程式中納入此動作，這樣您就可以更輕鬆地參考該輸出中的資料。

"Parse_JSON": {
   "type": "ParseJson",
   "inputs": {
      "content": "<JSON-source>",
         "schema": { "<JSON-schema>" }
      },
      "runAfter": {}
},

必要

值	類型	Description
<JSON-source>	JSON 物件	您想要剖析的 JSON 內容
<JSON-schema>	JSON 物件	說明基礎 JSON 內容的 JSON 結構描述，動作會用它來剖析來源 JSON 內容。提示：在 Logic Apps 設計工具中，您可以提供此結構描述，或提供範例承載讓動作得以產生結構描述。

範例

此動作定義會在您的邏輯應用程式工作流程中建立下列可供您使用的權杖，但僅限用於執行下列剖析 JSON 動作的動作：

FirstName、LastName 和 Email

"Parse_JSON": {
   "type": "ParseJson",
   "inputs": {
      "content": {
         "Member": {
            "Email": "Sophie.Owen@contoso.com",
            "FirstName": "Sophie",
            "LastName": "Owen"
         }
      },
      "schema": {
         "type": "object",
         "properties": {
            "Member": {
               "type": "object",
               "properties": {
                  "Email": {
                     "type": "string"
                  },
                  "FirstName": {
                     "type": "string"
                  },
                  "LastName": {
                     "type": "string"
                  }
               }
            }
         }
      }
   },
   "runAfter": { }
},

在此範例中，"content" 屬性會指定動作要剖析的 JSON 內容。您也可以提供此 JSON 內容作為用來產生結構描述的範例承載。

"content": {
   "Member": { 
      "FirstName": "Sophie",
      "LastName": "Owen",
      "Email": "Sophie.Owen@contoso.com"
   }
},

"schema" 屬性會指定用來說明 JSON 內容的 JSON 結構描述：

"schema": {
   "type": "object",
   "properties": {
      "Member": {
         "type": "object",
         "properties": {
            "FirstName": {
               "type": "string"
            },
            "LastName": {
               "type": "string"
            },
            "Email": {
               "type": "string"
            }
         }
      }
   }
}

查詢動作

此動作會根據指定的條件或篩選條件，從另一個陣列中的項目建立陣列。

"Filter_array": {
   "type": "Query",
   "inputs": {
      "from": <array>,
      "where": "<condition-or-filter>"
   },
   "runAfter": {}
}

必要

值	類型	描述
<array>	Array	提供來源項目的陣列或運算式。如果您指定運算式，請以雙引號括住該運算式。
<condition-or-filter>	String	用來對來源陣列中的項目進行篩選的條件注意：如果沒有符合條件的值，則動作會建立空陣列。

範例

此動作定義會建立值大於指定值 (2) 的陣列：

"Filter_array": {
   "type": "Query",
   "inputs": {
      "from": [ 1, 3, 0, 5, 4, 2 ],
      "where": "@greater(item(), 2)"
   }
}

回應動作

此動作會建立 HTTP 要求的回應承載。

"Response" {
    "type": "Response",
    "kind": "http",
    "inputs": {
        "statusCode": 200,
        "headers": { <response-headers> },
        "body": { <response-body> }
    },
    "runAfter": {}
},

必要

值	類型	Description
<response-status-code>	整數	要傳送至連入要求的 HTTP 狀態碼。預設代碼為「200 確定」，但代碼可以是任何以 2xx、4xx 或 5xx (不含 3xxx) 開頭的有效狀態碼。

選擇性

值	類型	Description
<response-headers>	JSON 物件	要隨附於回應的一個或多個標頭
<response-body>	各種類型	回應本文，可以是字串、JSON 物件，甚至是上一節中的二進位內容

範例

此動作定義會使用指定的狀態碼、訊息本文和訊息標頭建立 HTTP 要求的回應：

"Response": {
   "type": "Response",
   "inputs": {
      "statusCode": 200,
      "body": {
         "ProductID": 0,
         "Description": "Organic Apples"
      },
      "headers": {
         "x-ms-date": "@utcnow()",
         "content-type": "application/json"
      }
   },
   "runAfter": {}
}

限制

不同於其他動作，回應動作有其特殊限制：

只有在工作流程以 HTTP 要求觸發程序啟動時，您的工作流程才可以使用回應動作，這表示您的工作流程必須由 HTTP 要求觸發。
您的工作流程可以在 Foreach 迴圈、Until 迴圈 (包括循序迴圈) 和平行分支以外的任何位置使用回應動作。
只有在 [回應] 動作所需的所有動作都已在 HTTP 要求逾時限制內完成時，原始的 HTTP 要求才會取得工作流程的回應。

不過，如果您的工作流程呼叫另一個邏輯應用程式作為巢狀工作流程，父工作流程將會等待巢狀工作流程完成，無論在巢狀工作流程完成之前經過了多少時間。
當您的工作流程使用回應動作和同步回應模式時，工作流程不可同時在觸發程序定義中使用 splitOn 命令，因為該命令會建立多個執行。在使用 PUT 方法時，請檢查是否有此情況，如果有，請傳回「不正確的要求」回應。

否則，如果您的工作流程使用 splitOn 命令和回應動作，工作流程將會以非同步方式執行，並立即傳回「202 已接受」回應。
如果您的工作流程執行觸及回應動作，但連入要求已接收回到應，回應動作會因為衝突而標示為「失敗」。因此，您的邏輯應用程式執行也會標示為「失敗」狀態。

選取動作

此動作會根據指定的對應從另一個陣列中轉換項目，以使用 JSON 物件建立陣列。來源陣列與輸出陣列一律有相同數目的項目。雖然您無法變更輸出陣列中的物件數目，但您可以為這些物件新增或移除屬性及其值。 select 屬性會指定至少一個索引鍵/值組，用以定義轉換來源陣列中的項目時的對應。索引鍵/值組代表輸出陣列中所有物件的屬性及其值。

"Select": {
   "type": "Select",
   "inputs": {
      "from": <array>,
      "select": { 
          "<key-name>": "<expression>",
          "<key-name>": "<expression>"        
      }
   },
   "runAfter": {}
},

必要

值	類型	描述
<array>	Array	提供來源項目的陣列或運算式。請確實以雙引號括住運算式。注意：如果來源陣列是空的，動作將會建立空陣列。
<key-name>	String	為 <<expression> 的結果指派的屬性名稱若要為輸出陣列中的所有物件新增屬性，請為該屬性提供 <<key-name>>，並提供 < <expression>> 作為屬性值。若要移除陣列中所有物件的屬性，請省略該屬性的 <<key-name>>。
<expression>	String	轉換來源陣列中的項目，並將結果指派給 <<key-name>> 的運算式

選取動作會建立陣列作為輸出，因此需要使用此輸出的任何動作都必須接受陣列，或者您必須將陣列轉換為取用者動作可接受的類型。例如，若要將輸出陣列轉換為字串，您可以將該陣列傳至撰寫動作，然後在您其他動作中參考撰寫動作的輸出。

範例

此動作定義會從整數陣列建立 JSON 物件陣列。此動作會逐一查看來源陣列、使用 @item() 運算式取得每個整數值，並將每個值指派給各個 JSON 物件中的 "number" 屬性：

"Select": {
   "type": "Select",
   "inputs": {
      "from": [ 1, 2, 3 ],
      "select": { 
         "number": "@item()" 
      }
   },
   "runAfter": {}
},

以下是此動作建立的陣列：

[ { "number": 1 }, { "number": 2 }, { "number": 3 } ]

若要在其他動作中使用此陣列輸出，請將此輸出傳至撰寫動作：

"Compose": {
   "type": "Compose",
   "inputs": "@body('Select')",
   "runAfter": {
      "Select": [ "Succeeded" ]
   }
},

然後，您即可在其他的動作中使用撰寫動作的輸出，例如，Office 365 Outlook - 傳送電子郵件動作：

"Send_an_email": {
   "type": "ApiConnection",
   "inputs": {
      "body": {
         "Body": "@{outputs('Compose')}",
         "Subject": "Output array from Select and Compose actions",
         "To": "<your-email@domain>"
      },
      "host": {
         "connection": {
            "name": "@parameters('$connections')['office365']['connectionId']"
         }
      },
      "method": "post",
      "path": "/Mail"
   },
   "runAfter": {
      "Compose": [ "Succeeded" ]
   }
},

資料表動作

此動作會從陣列建立 CSV 或 HTML 資料表。對於含有 JSON 物件的陣列，此動作會從物件的屬性名稱自動建立資料行標頭。對於含有其他資料類型的陣列，您必須指定資料行標頭和值。例如，下列陣列包含此動作可用於資料行標頭名稱的 "ID" 和 "Product_Name" 屬性：

[ {"ID": 0, "Product_Name": "Apples"}, {"ID": 1, "Product_Name": "Oranges"} ]

"Create_<CSV | HTML>_table": {
   "type": "Table",
   "inputs": {
      "format": "<CSV | HTML>",
      "from": <array>,
      "columns": [ 
         {
            "header": "<column-name>",
            "value": "<column-value>"
         },
         {
            "header": "<column-name>",
            "value": "<column-value>"
         } 
      ]
   },
   "runAfter": {}
}

必要

值	類型	Description
<<CSV或 HTML>>	String	您想要建立的資料表格式
<array>	Array	提供資料表來源項目的陣列或運算式注意：如果來源陣列是空的，動作將會建立空資料表。

選擇性

若要指定或自訂資料行標頭和值，請使用 columns 陣列。當 header-value 配對具有相同的標頭名稱時，其值將會出現在具有該標頭名稱的相同資料行中。否則，每個唯一的標頭分別會定義唯一的資料行。

值	類型	Description
<column-name>	String	資料行的標頭名稱
<column-value>	任意	該資料行中的值

範例 1

假設您有先前建立的 "myItemArray" 變數，且目前包含下列陣列：

[ {"ID": 0, "Product_Name": "Apples"}, {"ID": 1, "Product_Name": "Oranges"} ]

此動作定義會從 "myItemArray" 變數建立 CSV 資料表。 from 屬性所使用的運算式會透過 variables() 函式從 "myItemArray" 取得陣列：

"Create_CSV_table": {
   "type": "Table",
   "inputs": {
      "format": "CSV",
      "from": "@variables('myItemArray')"
   },
   "runAfter": {}
}

以下是此動作建立的 CSV 資料表：

ID,Product_Name 
0,Apples 
1,Oranges

範例 2

此動作定義會從 "myItemArray" 變數建立 HTML 資料表。 from 屬性所使用的運算式會透過 variables() 函式從 "myItemArray" 取得陣列：

"Create_HTML_table": {
   "type": "Table",
   "inputs": {
      "format": "HTML",
      "from": "@variables('myItemArray')"
   },
   "runAfter": {}
}

以下是此動作建立的 HTML 資料表：

識別碼	Product_Name
0	蘋果
1	橘子

範例 3

此動作定義會從 "myItemArray" 變數建立 HTML 資料表。不過，此範例會以 "Stock_ID" 和 [描述] 覆寫預設資料行標頭名稱，並將「有機」一詞新增至 [描述] 資料行中的值。

"Create_HTML_table": {
   "type": "Table",
   "inputs": {
      "format": "HTML",
      "from": "@variables('myItemArray')",
      "columns": [ 
         {
            "header": "Stock_ID",
            "value": "@item().ID"
         },
         {
            "header": "Description",
            "value": "@concat('Organic ', item().Product_Name)"
         }
      ]
    },
   "runAfter": {}
},

以下是此動作建立的 HTML 資料表：

Stock_ID	描述
0	有機蘋果
1	有機橘子

終止動作

此動作會停止執行邏輯應用程式工作流程執行個體、取消任何進行中的動作、略過其餘任何動作，並傳回指定的狀態。例如，您可以在邏輯應用程式因錯誤狀態而必須完全結束時，使用終止動作。此動作不會影響已完成的動作，且不可出現在 Foreach 和 Until 迴圈 (包括循序迴圈) 內。

"Terminate": {
   "type": "Terminate",
   "inputs": {
       "runStatus": "<status>",
       "runError": {
            "code": "<error-code-or-name>",
            "message": "<error-message>"
       }
   },
   "runAfter": {}
}

必要

值	類型	Description
<status>	String	要傳回的執行狀態：「失敗」、「已取消」或「成功」

選擇性

只有在 "runStatus" 屬性設定為 [失敗] 狀態時，才適用 "runStatus" 物件的屬性。

值	類型	Description
<error-code-or-name>	String	錯誤的代碼或名稱
<error-message>	String	說明錯誤和應用程式使用者可行動作的訊息或文字

範例

此動作定義會停止執行工作流程、將執行狀態設定為 [失敗]，並傳回的狀態、錯誤碼和錯誤訊息：

"Terminate": {
    "type": "Terminate",
    "inputs": {
        "runStatus": "Failed",
        "runError": {
            "code": "Unexpected response",
            "message": "The service received an unexpected response. Please try again."
        }
   },
   "runAfter": {}
}

等候動作

此動作會在一段指定間隔內暫停工作流程的執行，或暫停到指定的時間為止 (並非同時滿足二個條件)。

指定的間隔

"Delay": {
   "type": "Wait",
   "inputs": {
      "interval": {
         "count": <number-of-units>,
         "unit": "<interval>"
      }
   },
   "runAfter": {}
},

指定的時間

"Delay_until": {
   "type": "Wait",
   "inputs": {
      "until": {
         "timestamp": "<date-time-stamp>"
      }
   },
   "runAfter": {}
},

必要

值	類型	Description
<number-of-units>	整數	針對延遲動作要等候的單位數
<interval>	String	針對延遲動作要等候的間隔：[秒]、[分]、[小時]、[天]、[週]、[月]
<date-time-stamp>	String	針對延遲到動作，要繼續執行的日期和時間。此值必須使用 UTC 日期時間格式。

範例 1

此動作定義會暫停工作流程 15 分鐘：

"Delay": {
   "type": "Wait",
   "inputs": {
      "interval": {
         "count": 15,
         "unit": "Minute"
      }
   },
   "runAfter": {}
},

範例 2

此動作定義會暫停工作流程，直到指定的時間到達：

"Delay_until": {
   "type": "Wait",
   "inputs": {
      "until": {
         "timestamp": "2017-10-01T00:00:00Z"
      }
   },
   "runAfter": {}
},

工作流程動作

此動作會呼叫先前建立的另一個邏輯應用程式，這表示您可以包含並重複使用其他的邏輯應用程式工作流程。您也可以在巢狀邏輯應用程式之後的動作中使用子系或巢狀邏輯應用程式的輸出，只要子系邏輯應用程式傳回回應即可。

Logic Apps 引擎會檢查是否可存取您想要呼叫的觸發程序，因此請確定您可以存取該觸發程序。此外，巢狀邏輯應用程式必須符合下列準則：

觸發程序會使巢狀邏輯應用程式可供呼叫，例如要求或 HTTP 觸發程序
與父邏輯應用程式相同的 Azure 訂用帳戶
若要在父邏輯應用程式中使用巢狀邏輯應用程式的輸出，巢狀邏輯應用程式必須具有回應動作

"<nested-logic-app-name>": {
   "type": "Workflow",
   "inputs": {
      "body": { "<body-content" },
      "headers": { "<header-content>" },
      "host": {
         "triggerName": "<trigger-name>",
         "workflow": {
            "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group>/providers/Microsoft.Logic/<nested-logic-app-name>"
         }
      }
   },
   "runAfter": {}
}

必要

值	類型	Description
<nested-logic-app-name>	String	您要呼叫的邏輯應用程式所具備的名稱
<trigger-name>	String	您要呼叫的巢狀邏輯應用程式中包含的觸發程序名稱
<Azure-subscription-ID>	String	巢狀邏輯應用程式的 Azure 訂用帳戶識別碼
<Azure-resource-group>	String	巢狀邏輯應用程式的 Azure 資源群組名稱

選擇性

值	類型	Description
<header-content>	JSON 物件	要透過呼叫傳送的任何標頭
<body-content>	JSON 物件	要透過呼叫傳送的任何訊息內容

輸出

此動作的輸出會隨著巢狀邏輯應用程式的回應動作而有所不同。如果巢狀邏輯應用程式未包含回應動作，輸出會是空的。

範例

在 "Start_search" 動作順利完成後，此工作流程動作定義會呼叫名為 "Get_product_information" 的另一個邏輯應用程式，而傳入指定的輸入：

"actions": {
   "Start_search": { <action-definition> },
   "Get_product_information": {
      "type": "Workflow",
      "inputs": {
         "body": {
            "ProductID": "24601",
         },
         "host": {
            "id": "/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/InventoryManager-RG/providers/Microsoft.Logic/Get_product_information",
            "triggerName": "Find_product"
         },
         "headers": {
            "content-type": "application/json"
         }
      },
      "runAfter": { 
         "Start_search": [ "Succeeded" ]
      }
   }
},

控制工作流程動作詳細資料

Foreach 動作

此迴圈動作會逐一查看陣列，並對每個陣列項目執行動作。根據預設，"for each" 迴圈會依據迴圈數目上限以平行方式執行。如需此最大值，請參閱限制和設定。了解如何建立 for each 迴圈。

"For_each": {
   "type": "Foreach",
   "actions": { 
      "<action-1>": { "<action-definition-1>" },
      "<action-2>": { "<action-definition-2>" }
   },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "runtimeConfiguration": {
      "concurrency": {
         "repetitions": <count>
      }
    },
    "operationOptions": "<operation-option>"
}

必要

值	類型	Description
<action-1...n>	String	對每個陣列項目執行的動作名稱
<action-definition-1...n>	JSON 物件	所執行動作的定義
<for-each-expression>	String	參考指定陣列中各個項目的運算式

選擇性

值	類型	描述
<count>	整數	根據預設，"for each" 迴圈逐一查看會同時執行，或依據預設限制以平行方式執行。若要藉由設定新的 <<count> 值>來變更此限制，請參閱變更 "for each" 迴圈並行。
<operation-option>	String	若要以循序方式 (而非以平行方式) 執行 "for each" 迴圈，請將 <<operation-option>> 設定為 `Sequential` 或<將 >> 設定為 `1`，但請勿同時設定兩者。如需詳細資訊，請參閱循序執行 "for each" 迴圈。

範例

此 "for each" 迴圈會為陣列中的每個項目傳送電子郵件，其中包含內送電子郵件的附件。此迴圈會將內含附件的電子郵件傳送給檢閱附件的人員。

"For_each": {
   "type": "Foreach",
   "actions": {
      "Send_an_email": {
         "type": "ApiConnection",
         "inputs": {
            "body": {
               "Body": "@base64ToString(items('For_each')?['Content'])",
               "Subject": "Review attachment",
               "To": "Sophie.Owen@contoso.com"
                },
            "host": {
               "connection": {
                  "id": "@parameters('$connections')['office365']['connectionId']"
               }
            },
            "method": "post",
            "path": "/Mail"
         },
         "runAfter": {}
      }
   },
   "foreach": "@triggerBody()?['Attachments']",
   "runAfter": {}
}

若要指定僅傳入一個陣列作為觸發程序的輸出，此運算式會從觸發程序主體取得 <<array-name>> 陣列。為避免在此陣列不存在時導致作業失敗，運算式使用了 ? 運算子：

@triggerBody()?['<array-name>']

If 動作

此動作是條件陳述式，可用來評估代表條件的運算式，並根據是否符合條件來執行不同的分支。如果符合條件，此條件就會標示為「成功」狀態。了解如何建立條件陳述式。

"Condition": {
   "type": "If",
   "expression": { "<condition>" },
   "actions": {
      "<action-1>": { "<action-definition>" }
   },
   "else": {
      "actions": {
        "<action-2>": { "<action-definition" }
      }
   },
   "runAfter": {}
}

值	類型	Description
<condition>	JSON 物件	要評估的條件，可以是運算式
<action-1>	JSON 物件	<<condition>> 評估為 true 時所要執行的動作
<action-definition>	JSON 物件	動作的定義
<action-2>	JSON 物件	<<condition>> 評估為 false 時所要執行的動作

actions 或 else 物件中的動作會獲得下列狀態：

「Succeeded (成功)」：當動作執行且成功時
「Failed (失敗)」：當動作執行但失敗時
「Skipped (略過)」：當個別的分支並未實行時

範例

此條件會指定當整數變數的值大於零時，工作流程將會檢查網站。如果變數小於或等於零，則工作流程會檢查不同的網站。

"Condition": {
   "type": "If",
   "expression": {
      "and": [ {
         "greater": [ "@variables('myIntegerVariable')", 0 ] 
      } ]
   },
   "actions": { 
      "HTTP - Check this website": {
         "type": "Http",
         "inputs": {
         "method": "GET",
            "uri": "http://this-url"
         },
         "runAfter": {}
      }
   },
   "else": {
      "actions": {
         "HTTP - Check this other website": {
            "type": "Http",
            "inputs": {
               "method": "GET",
               "uri": "http://this-other-url"
            },
            "runAfter": {}
         }
      }
   },
   "runAfter": {}
}

條件使用運算式的方式

以下是說明如何在條件中使用運算式的範例︰

JSON	結果
"expression": "@parameters('<hasSpecialAction>')"	(僅限布林運算式) 條件會略過任何評估為 true 的值。若要將其他類型轉換成布林值，請使用函式：`empty()` 或 `equals()`。
"expression": "@greater(actions('<<action>>').output.value, parameters('<<threshold>>'))"	使用比較函式時，只有在 <<action>> 的輸出大於 <<threshold>> 值時，才會執行動作。
"expression": "@or(greater(actions('<<action>>').output.value, parameters('<<threshold>>')), less(actions('<<same-action>>').output.value, 100))"	使用邏輯函式和建立巢狀布林運算式時，若 <<action>> 的輸出大於 <<threshold>> 值或低於 100，則會執行動作。
"expression": "@equals(length(actions('<action>').outputs.errors), 0))"	您可以使用陣列函式來檢查陣列是否有任何項目。當 `errors` 陣列空白時，就會執行動作。

範圍動作

此動作會按邏輯將動作分成數個「範圍」，而在該範圍中的動作執行完成後取得自己的狀態。隨後，您可以使用範圍的狀態來判斷是否有其他動作在執行。了解如何建立範圍。

"Scope": {
   "type": "Scope",
   "actions": {
      "<inner-action-1>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      },
      "<inner-action-2>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      }
   }
}

必要

值	類型	Description
<inner-action-1...n>	JSON 物件	在範圍內執行的一或多個動作
<action-inputs>	JSON 物件	每個動作的輸入

Switch 動作

此動作也稱為 Switch 陳述式，會將其他動作組織為案例，並將值指派給每個案例，但預設的案例除外 (如果有的話)。當您的工作流程執行時，Switch 動作會將運算式、物件或權杖的值與每個案例的指定值做比較。如果 Switch 動作找到相符的案例，您的工作流程就只會執行該案例的動作。每當 Switch 動作執行時，都只會有一個相符的案例存在，或沒有相符案例存在。如果沒有相符項目存在，Switch 動作會執行預設動作。了解如何建立 Switch 陳述式。

"Switch": {
   "type": "Switch",
   "expression": "<expression-object-or-token>",
   "cases": {
      "Case": {
         "actions": {
           "<action-name>": { "<action-definition>" }
         },
         "case": "<matching-value>"
      },
      "Case_2": {
         "actions": {
           "<action-name>": { "<action-definition>" }
         },
         "case": "<matching-value>"
      }
   },
   "default": {
      "actions": {
         "<default-action-name>": { "<default-action-definition>" }
      }
   },
   "runAfter": {}
}

必要

值	類型	Description
<expression-object-or-token>	不定	要評估的運算式、JSON 物件或權杖
<action-name>	String	要為相符案例執行的動作所具備的名稱
<action-definition>	JSON 物件	要為相符案例執行的動作所具備的定義
<matching-value>	不定	要與評估的結果比較的值

選擇性

值	類型	Description
<default-action-name>	String	沒有相符案例存在時要執行的預設動作所具備的名稱
<default-action-definition>	JSON 物件	沒有相符案例存在時要執行的動作所具備的定義

範例

此動作定義會評估核准要求電子郵件的回應者是選取了 [核准] 選項還是 [拒絕] 選項。根據此選擇，Switch 動作會執行相符案例的動作，也就是將另一則電子郵件傳送給回應者，但在每個案例中使用不同的用詞。

"Switch": {
   "type": "Switch",
   "expression": "@body('Send_approval_email')?['SelectedOption']",
   "cases": {
      "Case": {
         "actions": {
            "Send_an_email": { 
               "type": "ApiConnection",
               "inputs": {
                  "Body": "Thank you for your approval.",
                  "Subject": "Response received", 
                  "To": "Sophie.Owen@contoso.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/Mail"
            },
            "runAfter": {}
         },
         "case": "Approve"
      },
      "Case_2": {
         "actions": {
            "Send_an_email_2": { 
               "type": "ApiConnection",
               "inputs": {
                  "Body": "Thank you for your response.",
                  "Subject": "Response received", 
                  "To": "Sophie.Owen@contoso.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/Mail"
            },
            "runAfter": {}     
         },
         "case": "Reject"
      }
   },
   "default": {
      "actions": { 
         "Send_an_email_3": { 
            "type": "ApiConnection",
            "inputs": {
               "Body": "Please respond with either 'Approve' or 'Reject'.",
               "Subject": "Please respond", 
               "To": "Sophie.Owen@contoso.com"
            },
            "host": {
               "connection": {
                  "name": "@parameters('$connections')['office365']['connectionId']"
               }
            },
            "method": "post",
            "path": "/Mail"
         },
         "runAfter": {} 
      }
   },
   "runAfter": {
      "Send_approval_email": [ 
         "Succeeded"
      ]
   }
}

直到動作

此迴圈動作包含會持續執行直到符合指定條件為止的動作。迴圈會在所有其他動作都執行完成後，才在最後一個步驟檢查條件。您可以在 "actions" 物件中包含多個動作，而動作至少須定義一項限制。了解如何建立 "until" 迴圈。

 "Until": {
   "type": "Until",
   "actions": {
      "<action-name>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      },
      "<action-name>": {
         "type": "<action-type>",
         "inputs": { "<action-inputs>" },
         "runAfter": {}
      }
   },
   "expression": "<condition>",
   "limit": {
      "count": <loop-count>,
      "timeout": "<loop-timeout>"
   },
   "runAfter": {}
}

值	類型	Description
<action-name>	String	您要在迴圈內執行的動作名稱
<action-type>	String	您要執行的動作類型
<action-inputs>	各種類型	要執行的動作所使用的輸入
<condition>	String	在迴圈中的所有動作都執行完成後所要評估的條件或運算式
<loop-count>	整數	動作可以執行的迴圈數目上限。如需預設限制和上限的詳細資訊，請參閱Azure Logic Apps 的限制和設定。
<loop-timeout>	String	迴圈可執行的時間長度上限。預設 `timeout` 值為 `PT1H`，這是必要的 ISO 8601 格式。

注意

如果運算式相依於 Until 迴圈中任何動作的輸出，請確定您考慮該動作所產生的任何失敗。

範例

此迴圈動作定義會持續將 HTTP 要求傳送至指定的 URL，直到符合下列條件之一為止：

要求取得狀態碼為「200 確定」的回應。
迴圈已執行 60 次。
迴圈執行已達一小時。

 "Run_until_loop_succeeds_or_expires": {
    "type": "Until",
    "actions": {
        "HTTP": {
            "type": "Http",
            "inputs": {
                "method": "GET",
                "uri": "http://myurl"
            },
            "runAfter": {}
        }
    },
    "expression": "@equals(outputs('HTTP')['statusCode'], 200)",
    "limit": {
        "count": 60,
        "timeout": "PT1H"
    },
    "runAfter": {}
}

Webhook 和訂閱

以 Webhook 為基礎的觸發程序和動作不會定期檢查端點，而是會等待這些端點的特定事件或資料。這些觸發程序和動作會藉由提供可讓端點傳送回應的回呼 URL，來訂閱端點。

當工作流程以任何方式發生變更時 (例如，當認證更新，或觸發程序或動作的輸入參數變更時)，就會進行 subscribe 呼叫。此呼叫使用與標準 HTTP 動作相同的參數。

當作業使觸發程序或動作失效時，就會自動進行 unsubscribe 呼叫，例如：

刪除或停用觸發程序。
刪除或停用工作流程。
刪除或停用訂用帳戶。

為了支援這些呼叫，@listCallbackUrl() 運算式會為觸發程序或動作傳回唯一的「回呼 URL」。此 URL 代表使用服務 REST API 之端點的唯一識別碼。此函式的參數與 Webhook 觸發程序或動作的參數相同。

變更非同步持續時間

對於觸發程序和動作，您都可以藉由新增 limit.timeout 屬性，將非同步模式的持續時間限定於特定的時間間隔。如此，若動作在間隔結束後仍未完成，動作的狀態就會標示為 Cancelled，且附有 ActionTimedOut 代碼。 timeout 屬性會使用 ISO 8601 格式。

"<trigger-or-action-name>": {
   "type": "Workflow | Webhook | Http | ApiConnectionWebhook | ApiConnection",
   "inputs": {},
   "limit": {
      "timeout": "PT10S"
   },
   "runAfter": {}
}

執行階段組態設定

您可以使用觸發程序或動作定義中的下列 runtimeConfiguration 屬性，變更觸發程序和動作的預設執行階段行為。

屬性	類型	Description	觸發程序或動作
`runtimeConfiguration.concurrency.runs`	整數	變更可同時 (或以平行方式) 執行的邏輯應用程式執行個體數目的預設限制。此值有助於限制後端系統接收的要求數目。將 `runs` 屬性設定為 `1` 的效用，與將 `operationOptions` 屬性設定為 `SingleInstance` 相同。您可以設定任一屬性，但勿同時設定。若要變更預設限制，請參閱變更觸發程序並行或循序觸發執行個體。	所有觸發程序
`runtimeConfiguration.concurrency.maximumWaitingRuns`	整數	變更當您的邏輯應用程式所執行的並行執行個體數目已達上限時，可以等候執行的邏輯應用程式執行個體數目的預設限制。若要變更預設限制，請參閱變更等候執行限制。	所有觸發程序
`runtimeConfiguration.concurrency.repetitions`	整數	變更可同時 (或以平行方式) 執行的 "for each" 迴圈反覆項目數的預設限制。將 `repetitions` 屬性設定為 `1` 的效用，與將 `operationOptions` 屬性設定為 `SingleInstance` 相同。您可以設定任一屬性，但勿同時設定。若要變更預設限制，請參閱變更 "for each" 並行或循序執行 "for each" 迴圈。	動作： Foreach
`runtimeConfiguration.paginationPolicy.minimumItemCount`	整數	針對支援並開啟分頁的特定動作，此值會指定要擷取的結果數目下限。若要開啟分頁，請參閱使用分頁取得大量資料、項目或結果	動作：不同
`runtimeConfiguration.secureData.properties`	Array	許多觸發程序和動作都有設定，可保護來自邏輯應用程式執行歷程記錄的輸入、輸出或兩者。若要深入了解如何保護此資料，請參閱隱藏執行歷程記錄中的輸入和輸出。	多數觸發程序及動作
`runtimeConfiguration.staticResult`	JSON 物件	對於支援且已開啟靜態結果設定的動作， `staticResult`物件具有下列屬性： - `name`，參考目前動作的靜態結果定義名稱，該名稱會出現在邏輯應用程式工作流程 `staticResults` 屬性中的屬性內 `definition`。如需詳細資訊，請參閱靜態結果 - 工作流程定義語言的架構參考。 - `staticResultOptions`，指定靜態結果 `Enabled` 是否為目前動作。若要開啟靜態結果，請參閱設定靜態結果以模擬資料測試邏輯應用程式	動作：不同

作業選項

您可以使用觸發程序或動作定義中的 operationOptions 屬性，變更觸發程序和動作的預設行為。

作業選項	類型	Description	觸發程序或動作
`DisableAsyncPattern`	String	同步執行 HTTP 型動作，而不是非同步執行。若要設定此選項，請參閱以同步方式執行動作。	動作： ApiConnection、 HTTP、回應
`IncludeAuthorizationHeadersInOutputs`	String	對於啟用 Azure Active Directory Open Authentication (Azure AD OAuth 的邏輯應用程式，) 授權對要求型觸發程式端點進行輸入呼叫的存取權，請在`Authorization`觸發程式輸出中包含來自 OAuth 存取權杖的標頭。如需詳細資訊，請參閱在要求觸發程式輸出中包含「授權」標頭。	觸發程序：要求， HTTP Webhook
`Sequential`	String	逐一執行 "for each" 迴圈反覆項目，而非一併以平行方式同時執行。此選項的效用與將 `runtimeConfiguration.concurrency.repetitions` 屬性設定為 `1` 相同。您可以設定任一屬性，但勿同時設定。若要設定此選項，請參閱循序執行 "for each" 迴圈。	動作： Foreach
`SingleInstance`	String	循序為每個邏輯應用程式執行個體執行觸發程序，並等候先前作用中的執行完成後，再觸發下一個邏輯應用程式執行個體。此選項的效用與將 `runtimeConfiguration.concurrency.runs` 屬性設定為 `1` 相同。您可以設定任一屬性，但勿同時設定。若要設定此選項，請參閱循序觸發執行個體。	所有觸發程序
`SuppressWorkflowHeaders`	String	請勿在輸出要求中傳送 `x-ms-*` 中繼資料標頭。根據預設，Azure Logic Apps 服務會在輸出要求中包含標頭名稱中前置 `x-ms-` 詞的額外中繼資料標頭。不過，某些舊版服務不接受具有額外未知標頭的要求，導致要求失敗。	動作： HTTP、函式， APIManagement
`SuppressWorkflowHeadersOnResponse`	String	請勿在回應輸入觸發程式要求時傳送`x-ms-*`中繼資料標頭。根據預設，Azure Logic Apps 服務會將回應傳送至包含標頭名稱中前置詞的額外中繼資料標頭`x-ms-`的輸入要求。不過，某些舊版服務不接受具有額外未知標頭的要求獲回應，導致要求失敗。	觸發程序：要求， HTTP Webhook

變更觸發程序並行

根據預設，邏輯應用程式執行個體會以並行的方式同時執行 (同時或平行方式執行)。此行為表示每個觸發程式實例會在先前作用中的工作流程實例完成執行之前引發。不過，同時執行的個體數目有預設限制。當同時執行的工作流程實例數目達到此限制時，任何其他新執行個體都必須等候執行。此限制有助於控制後端系統接收的要求數目。

當您開啟觸發程式的並行控制時，觸發程式實例會以平行方式執行到預設限制。若要變更預設限制，您可以使用程式碼檢視編輯器或 Logic Apps 設計工具，因為透過此設計工具變更並行設定，會新增或更新基礎觸發程序定義中的 runtimeConfiguration.concurrency.runs 屬性，反之亦然。此屬性可控制能夠以平行方式執行的邏輯應用程式執行個體數目上限。

在觸發程式上啟用並行之前，請先檢閱下列考量：

啟用並行控制之後，您無法停用平行存取。
若並行觸發程序執行的最大數目上限達到平行處理原則的最大程度，後續觸發程式執行可能會遇到節流或「429 - 太多要求」錯誤。若您設定處理 429 錯誤的重試原則，該觸發程序可能會遇到重試和節流行為的迴圈，進而導致處理新觸發程序要求時發生長時間的延遲。
當並行開啟時，解除批次處理陣列的 SplitOn 限制會大幅降低。如果專案數目超過此限制，則會停用 SplitOn 功能。
當並行開啟時，長時間執行的邏輯應用程式實例可能會導致新的邏輯應用程式實例進入等候狀態。此狀態可防止 Azure Logic Apps 建立新的實例，即使並存執行數目小於指定的並存執行數目上限，也會發生此狀況。
- 若要中斷此狀態，請取消仍在執行的最早實例。
  1. 在邏輯應用程式功能表上，選取 [概觀]。
  2. 在 [執行歷程記錄] 區段中，選取仍在執行的最早實例，例如：
    
    提示
    
    若要只檢視仍在執行的實例，請開啟 [所有] 清單，然後選取 [執行中]。
  3. 在 [邏輯應用程式執行] 中，選取 [執行詳細資料]。
- 若要解決此問題，請將逾時新增至任何可能保留這些流程的動作。如果您在程式碼編輯器中工作，請參閱變更非同步持續時間。否則，如果您使用設計工具，請遵循下列步驟：
  1. 在您的邏輯應用程式工作流程中，選取您要新增逾時的動作。在該動作的右上角，選取省略符號 (...) 按鈕，然後選取 [設定]。
  2. 在 [逾時] 下，以 ISO 8601 格式指定逾時持續時間。
若要循序執行邏輯應用程式，請使用程式碼檢視編輯器或設計工具，將觸發程式的並行設定為 1。請確定您也不會在程式碼檢視編輯器中將觸發 operationOptions 程式的屬性設定為 SingleInstance。否則，將會發生驗證錯誤。如需詳細資訊，請參閱循序觸發執行個體。

在程式碼檢視中編輯

在基礎觸發程式定義中 runtimeConfiguration.concurrency.runs ，新增屬性，並根據觸發程式並行限制設定值。若要循序執行工作流程，請將屬性值設定為 1。

以下是將並行執行的執行個體限制為 10 個的範例：

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": 10
      }
   }
}

如需詳細資訊，請參閱執行階段組態設定。

在 Logic Apps 設計工具中編輯

在觸發程序上，選取右上角的省略號 (...) 按鈕，然後選取 [設定]。
在 [並行控制] 底下，將 [限制] 設定成 [開啟]。
將 [平行處理原則的程度] 滑桿拖曳至您要的值。若要循序執行邏輯應用程式，將滑桿值拖曳至 [1]。

變更 "for each" 並行

根據預設，"for each" 迴圈逐一查看會同時執行 (同時或平行方式執行)。此行為表示每個反覆項目都會在先前的反覆項目完成執行之前開始執行。不過，同時執行的反覆項目有預設限制。當同時執行的反覆項目達到此限制時，任何其他反覆項目都必須等候執行。

若要變更預設限制，您可以使用程式碼檢視編輯器或 Logic Apps 設計工具，因為透過此設計工具變更並行設定，會新增或更新基礎 "for each" 動作定義中的 runtimeConfiguration.concurrency.repetitions 屬性，反之亦然。此屬性可控制能夠以平行方式執行的反覆項目數上限。

注意

如果您使用設計工具或程式碼檢視編輯器將 "for each" 動作設定為循序執行，請勿在程式碼檢視編輯器中將此動作的 operationOptions 屬性設定為 Sequential。否則，將會發生驗證錯誤。如需詳細資訊，請參閱循序執行 "for each" 迴圈。

在程式碼檢視中編輯

在基礎 “for each” 定義中，新增或更新 runtimeConfiguration.concurrency.repetitions 屬性，其值範圍可以是1 和 50。

以下是將並行執行的反覆項目限制為 10 個的範例：

"For_each" {
   "type": "Foreach",
   "actions": { "<actions-to-run>" },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "runtimeConfiguration": {
      "concurrency": {
         "repetitions": 10
      }
   }
}

如需詳細資訊，請參閱執行階段組態設定。

在 Logic Apps 設計工具中編輯

在 For each 動作的右上角選擇省略符號 (...) 按鈕，然後選擇 [設定]。
在 [並行控制] 底下，將 [並行控制] 設定成 [開啟]。
將 [平行處理原則的程度] 滑桿拖曳至您要的值。若要循序執行邏輯應用程式，將滑桿值拖曳至 [1]。

變更等候執行數限制

根據預設，邏輯應用程式執行個體會以並行的方式同時執行 (同時或平行方式執行)。此行為表示每個觸發程式實例會在先前作用中的工作流程實例完成執行之前引發。不過，同時執行的個體數目有預設限制。當同時執行的工作流程實例數目達到此限制時，任何其他新執行個體都必須等候執行。

等候執行數目也有預設限制。當等候執行數目達到此限制時，Logic Apps 引擎將不再接受新的執行。要求和 Webhook 觸發程序會傳回 429 錯誤，且週期性觸發程序會開始略過輪詢嘗試。

您不僅可以變更觸發程式並行的預設限制，也可以變更等候執行的預設限制。在基礎觸發程式定義中 runtimeConfiguration.concurrency.maximumWaitingRuns ，新增屬性，這個屬性可以有範圍從 1 到 100 的值。

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "runtimeConfiguration": {
      "concurrency": {
         "maximumWaitingRuns": 50
      }
   }
}

如需詳細資訊，請參閱執行階段組態設定。

循序觸發執行個體

若要每個邏輯應用程式執行個體都要等到前一個執行個體執行完成後才執行，請將觸發程序設定為循序執行。您可以使用程式碼檢視編輯器或 Logic Apps 設計工具，因為透過此設計工具變更並行設定，也會新增或更新基礎觸發程序定義中的 runtimeConfiguration.concurrency.runs 屬性，反之亦然。

注意

如果您使用設計工具或程式碼檢視編輯器將觸發程序設定為循序執行，請勿在程式碼檢視編輯器中將觸發程序的 operationOptions 屬性設定為 Sequential。否則，將會發生驗證錯誤。

在程式碼檢視中編輯

在觸發程序定義中設定其中一個屬性，但勿同時設定。

將 runtimeConfiguration.concurrency.runs 屬性設定為 1：

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "runtimeConfiguration": {
      "concurrency": {
         "runs": 1
      }
   }
}

-或-

將 operationOptions 屬性設定為 SingleInstance：

"<trigger-name>": {
   "type": "<trigger-name>",
   "recurrence": {
      "frequency": "<time-unit>",
      "interval": <number-of-time-units>,
   },
   "operationOptions": "SingleInstance"
}

如需詳細資訊，請參閱執行階段組態設定和作業選項。

在 Logic Apps 設計工具中編輯

在觸發程序上，選取右上角的省略號 (...) 按鈕，然後選取 [設定]。
在 [並行控制] 底下，將 [限制] 設定成 [開啟]。
將 [平行處理原則的程度] 滑桿拖曳至數字 1。

循序執行 "for each" 迴圈

若要等到上一個反覆項目執行完成後才執行 "for each" 迴圈反覆項目，請將 "for each" 動作設定為循序執行。您可以使用程式碼檢視編輯器或 Logic Apps 設計工具，因為透過此設計工具變更動作的並行，也會新增或更新基礎動作定義中的 runtimeConfiguration.concurrency.repetitions 屬性，反之亦然。

注意

如果您使用設計工具或程式碼檢視編輯器將 "for each" 動作設定為循序執行，請勿在程式碼檢視編輯器中將此動作的 operationOptions 屬性設定為 Sequential。否則，將會發生驗證錯誤。

在程式碼檢視中編輯

在動作定義中設定其中一個屬性，但勿同時設定。

將 runtimeConfiguration.concurrency.repetitions 屬性設定為 1：

"For_each" {
   "type": "Foreach",
   "actions": { "<actions-to-run>" },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "runtimeConfiguration": {
      "concurrency": {
         "repetitions": 1
      }
   }
}

-或-

將 operationOptions 屬性設定為 Sequential：

"For_each" {
   "type": "Foreach",
   "actions": { "<actions-to-run>" },
   "foreach": "<for-each-expression>",
   "runAfter": {},
   "operationOptions": "Sequential"
}

如需詳細資訊，請參閱執行階段組態設定和作業選項。

在 Logic Apps 設計工具中編輯

在 For each 動作的右上角選擇省略符號 (...) 按鈕，然後選擇 [設定]。
在 [並行控制] 底下，將 [並行控制] 設定成 [開啟]。
將 [平行處理原則的程度] 滑桿拖曳至數字 1。

在同步作業模式中執行動作

依預設，Azure Logic Apps 的 HTTP 動作和 APIConnection 動作會遵循標準非同步作業模式，，而回應動作則會遵循「同步作業模式」。此模式規定在 HTTP 動作呼叫或將要求傳送至端點、服務、系統或 API 之後，接收者立即傳回 "202 ACCEPTED" 回應。此代碼確認接收者已接受要求，但尚未完成處理。回應可能包含 location 標頭來指定 URI，還包含重新整理識別碼，可供呼叫者輪詢或檢查非同步要求的狀態，直到接收者停止處理並傳回 "200 OK" 成功回應或其他非 202 回應為止。如需詳細資訊，請參閱非同步微服務整合強制微服務自主性。

在邏輯應用程式設計工具中，HTTP 動作、APIConnection 動作和回應動作具有非同步模式設定。啟用時，此設定會指定呼叫端不會等候處理完成，而且可以繼續進行下一個動作，但會繼續檢查狀態，直到處理停止為止。如果停用，此設定會指定呼叫端等候處理完成，再繼續進行下一個動作。若要尋找此設定，請遵循下列步驟：
1. 在 HTTP 動作的標題列上，選取省略號 (...) 按鈕，這會開啟動作的設定。
2. 尋找 [非同步模式] 設定。
在動作的基礎 JavaScript 物件標記法 (JSON) 定義中，HTTP 動作和 APIConnection 動作會隱含地遵循非同步作業模式。

在某些情況下，您可能會想要讓動作改為遵循同步模式。例如，當您使用 HTTP 動作時，您可能會想要：

在這些情況下，您可以使用下列選項同步執行動作：

如果有的話，請將該動作的輪詢版本取代為 Webhook 版本。
依照任一選項停用動作的非同步行為：
- 在邏輯應用程式設計工具中，關閉 [非同步模式] 設定。
- 在動作的基礎 JSON 定義中，新增"DisableAsyncPattern"作業選項。

關閉 [非同步模式] 設定

在邏輯應用程式設計工具上，選取省略號 (...) 按鈕，這會開啟動作的設定。
尋找 [非同步模式] 設定，在啟用時設為 [關閉]，然後選取 [完成]。

停用動作 JSON 定義的非同步模式

在動作的基礎 JSON 定義中，將「operationOptions」屬性新增並設定在 "DisableAsyncPattern" 動作區 "inputs" 段底下，例如：

"<some-long-running-action>": {
   "type": "Http",
   "inputs": { "<action-inputs>" },
   "operationOptions": "DisableAsyncPattern",
   "runAfter": {}
}

驗證 HTTP 觸發程序和動作

HTTP 和 HTTPS 端點支援各種類型的驗證。當您發出輸出呼叫或要求來存取這些端點時，根據您使用的觸發程序或動作而定，有各種不同的驗證類型可供您選擇。如需詳細資訊，請參閱對於輸出驗證新增驗證。

下一步

深入了解工作流程定義語言

Azure Logic Apps 中觸發程式和動作類型的架構參考指南

觸發程序概觀

觸發程序類型清單

內建觸發程序

受控 API 觸發程序

觸發程序 - 詳細參考

APIConnection 觸發程序

ApiConnectionWebhook 觸發程序

HTTP 觸發程序

HTTPWebhook 觸發程序

循環觸發程序

要求觸發程序

觸發條件

在陣列上觸發多個執行程序

動作概觀

動作類型清單

內建動作

受控 API 動作

控制工作流程動作

動作 - 詳細參考

APIConnection 動作

APIConnectionWebhook 動作

撰寫動作

執行 JavaScript 程式碼動作

函式動作

HTTP 動作

聯結動作

剖析 JSON 動作

查詢動作

回應動作

選取動作

資料表動作

終止動作

等候動作

工作流程動作

控制工作流程動作詳細資料

Foreach 動作

If 動作

條件使用運算式的方式

範圍動作

Switch 動作

直到動作

Webhook 和訂閱

變更非同步持續時間

執行階段組態設定

作業選項

變更觸發程序並行

在程式碼檢視中編輯

在 Logic Apps 設計工具中編輯

變更 "for each" 並行

在程式碼檢視中編輯

在 Logic Apps 設計工具中編輯

變更等候執行數限制

循序觸發執行個體

在程式碼檢視中編輯

在 Logic Apps 設計工具中編輯

循序執行 "for each" 迴圈

在程式碼檢視中編輯

在 Logic Apps 設計工具中編輯

在同步作業模式中執行動作

關閉 [非同步模式] 設定

停用動作 JSON 定義的非同步模式

驗證 HTTP 觸發程序和動作

下一步

其他資源

其他資源