Creates a new workflow execution

POST

/amc/reporting/{{instanceId}}/workflowExecutions

最后修改时间：2025-03-16 02:19:30

责任人：未设置

Creates a new, ad-hoc execution of an existing workflow. Workflow executions are asyncronous and will typically take at least 15 minutes to execute. Ad-hoc executions can be used for testing, development, or one-off reporting use-cases; periodic executions can be achieved by creating a schedule for a given workflow.

The output from the execution will be placed in your S3 bucket in a similar location to normal scheduled executions, and the location can be found by looking at the OutputS3URI property of a workflow execution. At this time, adhoc workflow executions may be run up to 30 times per day, per AMC instance. This limit applies across all Workflow IDs.

请求参数

Header 参数

Body 参数application/json

示例

{
    "workflowId":"my-first-workflow",
    "timeWindowStart": "2024-01-20T00:00:00",
    "timeWindowEnd": "2024-01-25T00:00:00",
    "timeWindowType": "EXPLICIT",
    "timeWindowTimeZone": "America/New_York"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://www.amazon.com/ap/oa/amc/reporting/{{instanceId}}/workflowExecutions' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Amazon-Advertising-API-MarketplaceId: {{marketplace_id}}' \
--header 'Amazon-Advertising-API-AdvertiserId: {{advertiser_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workflowId":"my-first-workflow",
    "timeWindowStart": "2024-01-20T00:00:00",
    "timeWindowEnd": "2024-01-25T00:00:00",
    "timeWindowType": "EXPLICIT",
    "timeWindowTimeZone": "America/New_York"
}'

返回响应

🟢200Creates a new workflow execution

application/json

Body

示例

{
    "createTime": "2024-09-25T03:11:52Z",
    "dataGaps": [],
    "disableAggregationControls": false,
    "executionCategory": "AD_HOC",
    "expireTime": "2024-09-26T03:11:52Z",
    "ignoreDataGaps": false,
    "lastUpdatedTime": "2024-09-25T03:11:52Z",
    "parameterValues": {},
    "status": "PENDING",
    "timeWindowEnd": "2024-01-25T05:00:00Z",
    "timeWindowEndOriginal": "2024-01-25T00:00:00",
    "timeWindowStart": "2024-01-20T05:00:00Z",
    "timeWindowStartOriginal": "2024-01-20T00:00:00",
    "timeWindowTimeZoneOriginal": "America/New_York",
    "waitUntil": "2024-09-25T02:11:52Z",
    "workflowExecutionId": "b3a77999-7c8e-4289-9bf9-5da8f178536c",
    "workflowExecutionTimeoutSeconds": 21600,
    "workflowId": "my-first-workflow"
}

修改于 2025-03-16 02:19:30

Deletes the requested schedule

Returns a list of workflow executions