Suspensions API を使用すると、API 呼び出しによって一時停止を取り消すことができます。Suspensions API を使用して一時停止を取り消すには、統合の実行 ID または一時停止タスクの一時停止 ID が必要です。一時停止を取り消すには、次の API に POST リクエストを発行する必要があります。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["わかりにくい","hardToUnderstand","thumb-down"],["情報またはサンプルコードが不正確","incorrectInformationOrSampleCode","thumb-down"],["必要な情報 / サンプルがない","missingTheInformationSamplesINeed","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-09-03 UTC。"],[[["\u003cp\u003eThe Suspend task halts integration execution, allowing it to be resumed either after a set time or via a \u003ccode\u003eSuspensions\u003c/code\u003e API request.\u003c/p\u003e\n"],["\u003cp\u003eUnlike the Approval task, the Suspend task supports automatic resumption and doesn't require manual intervention, and unlike the Timer task, the Suspend task can be resumed via API calls.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure a \u003ccode\u003eSuspension result\u003c/code\u003e variable in the Suspend task to store a custom value, which can then be used for conditional branching in downstream tasks.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eSuspensions\u003c/code\u003e API allows revoking a suspension by using either the integration's execution ID or the Suspend task's suspension ID, or both, providing flexibility in managing integration flow.\u003c/p\u003e\n"],["\u003cp\u003eThe suspension time can be configured up to a maximum of 44640 minutes (31 days), and if not resumed earlier, the integration automatically continues after this time, with the \u003ccode\u003eSuspension result\u003c/code\u003e set to \u003ccode\u003eExpired\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Suspend task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nSuspend task\n============\n\nThe **Suspend** task lets you temporarily pause and then resume\nthe execution of an integration.\n\nDuring an integration execution, when the control reaches a Suspend task, execution is halted, and all tasks after the Suspend task are suspended. Integration\nresumes the execution when any of the following events occur:\n\n- Expiry of the specified suspension time.\n- After receiving a resume execution request from the `Suspensions` API.\n\nYou can also configure an output variable (**Suspension result**) for the Suspend task\nand set it to any value and use the value to create branching conditions for executing the downstream tasks.\n| **Note:** When a new version of the integration is published, any suspended executions of the previous version are automatically cancelled.\n\nCompare Approval task, Suspend task, and Timer task\n---------------------------------------------------\n\nAll the three ([Approval](/application-integration/docs/approval-task),\n[Suspend](/application-integration/docs/run-suspend-task),\nand [Timer](/application-integration/docs/run-timer-task)) tasks perform a similar\nfunction of pausing and resuming an integration. However, there are subtle differences\namong them. The following table describes the differences amongst the three tasks.\n\nConfigure the Suspend task\n--------------------------\n\nTo configure the **Suspend** task, perform the following steps:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **Suspend** task element in the integration editor.\n6. Click the **Suspend** task element on the designer to view the **Suspend** task configuration pane.\n7. Configure the remaining fields using the [Configuration properties](#params) for the task as detailed in the tables below.\n\n\n All changes to the properties are saved automatically.\n\nConfiguration properties\n------------------------\n\n\nThe following table describes the configuration properties of the Suspend task.\n\nRevoke a suspension with the Suspensions API\n--------------------------------------------\n\nThe Suspensions API lets you revoke a suspension via a API call. To revoke a suspension with\nthe **Suspensions** API, you must have either the execution ID of the integration or\nthe suspension ID of the Suspend task. To revoke a suspension, you\nmust issue a `POST` request to the following API: \n\n```\nhttps://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift\n \n```\n\nIn this API, the \u003cvar translate=\"no\"\u003eINTEGRATION_ID\u003c/var\u003e is optional. However, you must provide\neither the \u003cvar translate=\"no\"\u003eEXECUTION_ID\u003c/var\u003e or the \u003cvar translate=\"no\"\u003eSUSPENSION_ID\u003c/var\u003e. If you don't have any of\nthe ID values, you can substitute the value with `-`. In this API, \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e, \u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e, and \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e are required fields.\n| **Note:**\n|\n| - If you don't specify both the execution ID and the suspension ID, the API doesn't run and reports an error.\n| - If you don't specify the `suspension_result`, value of the suspension result is set to `Resolved`.\n\nAfter you revoke the suspension, integration execution resumes and executes\nthe downstream tasks after the Suspend task.\n\nThe following examples show how to revoke a suspension by using the **suspensions** API.\n\n### Example 1: Revoke a suspension with only the suspension ID\n\nThe following `curl` command shows you how to revoke a suspension when you only have the suspension ID: \n\n```\n curl -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-type: application/json\" \\\n -H X-GFE-SSL: yes \\\n -X POST \\\n -d '{\"suspension_result\":\"Approved\"}' \\\n https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift\n```\n\nIn this example, the `Suspension result` variable is set to `Approved`\nfor the supension ID `c6a13a79-a918-41e2-82b9-32b5a010755a`.\n\n### Example 2: Revoke a suspension with only the execution ID\n\nThe following `curl` command shows you how to revoke a suspension when you only have the execution ID: \n\n```\n curl -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-type: application/json\" \\\n -H X-GFE-SSL: yes \\\n -X POST \\\n -d '{\"suspension_result\":\"true\"}' \\\n https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift\n```\n\nIn this example, the `Suspension result` variable is set to `true`\nfor the execution ID `76a391e7-c801-45d7-8046-eab20d167ec5`.\n\n### Example 3: Revoke a suspension with both the execution ID and the suspension ID\n\nThe following `curl` command shows you how to revoke a suspension when you have both the execution ID and the suspension ID: \n\n```\n curl -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-type: application/json\" \\\n -H X-GFE-SSL: yes \\\n -X POST \\\n -d '{\"suspension_result\":\"{processname: \"Release\", owner: \"John\", status: \"approved\"};\"}' \\\n https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift\n```\n\nIn this example, the `Suspension result` variable is set to `{processname: \"Release\", owner: \"John\", status: \"approved\"};`\nfor the suspension ID `f01815bf-ed18-4e01-9d41-cc2ce7861e95`.\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
