{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"a37a67bccf97d1b343b0a9b4bfed2070"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"39933d88-217f-4607-b679-521117342169"}},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Use the CDAP Lifecycle Microservices to deploy or delete applications and manage the lifecycle of MapReduce (DEPRECATED) and Spark programs, custom services, workers, and workflows.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information about CDAP components, see ","type":"text"},{"text":"CDAP Components","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCS/pages/480346943"}}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"All methods or endpoints described in this API have a base URL (typically ","type":"text"},{"text":"http://:11015","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"https://:10443","type":"text","marks":[{"type":"code"}]},{"text":") that precedes the resource identifier, as described in the ","type":"text"},{"text":"Microservices Conventions","type":"text","marks":[{"type":"link","attrs":{"href":"https://cdap.atlassian.net/wiki/spaces/DOCS/pages/477692124/Microservices+Introduction#Microservices-Conventions"}}]},{"text":". These methods return a status code, as listed in the ","type":"text"},{"text":"Microservices Status Codes","type":"text","marks":[{"type":"link","attrs":{"href":"https://cdap.atlassian.net/wiki/spaces/DOCS/pages/477692124/API+Introduction#Status-Codes"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Application Lifecycle","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create an Application","type":"text"}]},{"type":"paragraph","content":[{"text":"To create an application, submit an HTTP PUT request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"PUT /v3/namespaces//apps/","type":"text"}]},{"type":"paragraph","content":[{"text":"(DEPRECATED)","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"To create an application with a non-default version, submit an HTTP POST request with the version specified:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//versions//create","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"74aedd09-4cda-43fb-bd89-1806492cc94d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[215.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[215.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[215.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[215.0]},"content":[{"type":"paragraph","content":[{"text":"version-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"(DEPRECATED) Version of the application, typically following ","type":"text"},{"text":"semantic versioning","type":"text","marks":[{"type":"link","attrs":{"href":"http://semver.org/"}}]},{"text":"; ","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"version-id","type":"text","marks":[{"type":"code"}]},{"text":" defaults to ","type":"text"},{"text":"-SNAPSHOT","type":"text","marks":[{"type":"code"}]},{"text":" when you don’t specify a ","type":"text"},{"text":"version-id","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body is a JSON object specifying the artifact to use to create the application, and an optional application configuration. ","type":"text"},{"text":"For example:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"384ab8b1-39f0-4216-b7e1-9fd88a2a8441"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"70ea7b7e-dbab-4705-8845-1e8865a92675"}}]}]},{"type":"codeBlock","content":[{"text":"PUT /v3/namespaces/default/apps/purchaseWordCount\n{\n \"artifact\": {\n \"name\": \"WordCount\",\n \"version\": \"6.8.0\",\n \"scope\": \"USER\"\n },\n \"config\": {\n “datasetName”: “purchases” \n },\n \"principal\":\"user/example.net@EXAMPLEKDC.NET\",\n \"app.deploy.update.schedules\":\"true\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"will create an application named ","type":"text"},{"text":"purchaseWordCount","type":"text","marks":[{"type":"code"}]},{"text":" from the example ","type":"text"},{"text":"WordCount","type":"text","marks":[{"type":"code"}]},{"text":" artifact. The application will receive the specified ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":", which will configure the application to create a dataset named ","type":"text"},{"text":"purchases","type":"text","marks":[{"type":"code"}]},{"text":" instead of using the default dataset name.","type":"text"}]},{"type":"paragraph","content":[{"text":"Optionally, you can specify a Kerberos principal with which the application should be deployed. If a Kerberos principal is specified, then all the datasets created by the application will be created with the application's Kerberos principal.","type":"text"}]},{"type":"paragraph","content":[{"text":"Optionally, you can set or reset the flag ","type":"text"},{"text":"app.deploy.update.schedules","type":"text","marks":[{"type":"code"}]},{"text":". If true, redeploying an application will modify any schedules that currently exist for the application; if false, redeploying an application does not create any new schedules and existing schedules are neither deleted nor updated.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Update an Application (DEPRECATED)","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"3c9c6a0e-bdbe-496c-b897-47916cb38117"}}]}]},{"type":"paragraph","content":[{"text":"To update an application, submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//update","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"70021a32-d046-4c3e-9117-058d46758877"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[479.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[479.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[281.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[479.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body is a JSON object specifying the updated artifact version and the updated application config. ","type":"text"},{"text":"For example","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"d5a1c7ee-93ac-4fa7-8fa4-f7a754e75617"}}]},{"text":", a request body of:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/apps/purchaseWordCount/update\n{\n \"artifact\": {\n \"name\": \"WordCount\",\n \"version\": \"6.8.0\",\n \"scope\": \"USER\"\n },\n \"config\": {\n “datasetName”: “logs”;\n },\n \"principal\":\"user/example.net@EXAMPLEKDC.NET\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"will update the ","type":"text"},{"text":"purchaseWordCount","type":"text","marks":[{"type":"code"}]},{"text":" application to use version ","type":"text"},{"text":"6.3.0","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"19389e4b-18d3-4ea6-b6c0-9d38d08b3584"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e344182d-8a59-4091-aabf-e7fbf9523a28"}}]},{"text":" ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e344182d-8a59-4091-aabf-e7fbf9523a28"}}]},{"text":"of the ","type":"text"},{"text":"WordCount","type":"text","marks":[{"type":"code"}]},{"text":" artifact, and update the name of the dataset to ","type":"text"},{"text":"logs","type":"text","marks":[{"type":"code"}]},{"text":". If no artifact is given, the current artifact will be used.","type":"text"}]},{"type":"paragraph","content":[{"text":"Only changes to artifact version are supported; changes to the artifact name are not allowed. If no ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":" is given, the current ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":" will be used. If the ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":" key is present, the current ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":" will be overwritten by the ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":" specified in the request. As the principal of an application cannot be updated, during an update the principal should either be the same or absent.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Deploy an Artifact and Application","type":"text"}]},{"type":"paragraph","content":[{"text":"To deploy an application from your local file system into the namespace ","type":"text"},{"text":"namespace-id","type":"text","marks":[{"type":"code"}]},{"text":", submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps","type":"text"}]},{"type":"paragraph","content":[{"text":"with the name of the JAR file as a header:","type":"text"}]},{"type":"codeBlock","content":[{"text":"X-Archive-Name: ","type":"text"}]},{"type":"paragraph","content":[{"text":"and Kerberos principal with which the application is to be deployed (if required):","type":"text"}]},{"type":"codeBlock","content":[{"text":"X-Principal: ","type":"text"}]},{"type":"paragraph","content":[{"text":"and enable or disable updating schedules of the existing workflows using the header:","type":"text"}]},{"type":"codeBlock","content":[{"text":"X-App-Deploy-Update-Schedules: ","type":"text"}]},{"type":"paragraph","content":[{"text":"This will add the JAR file as an artifact and then create an application from that artifact. The archive name must be in the form ","type":"text"},{"text":"-.jar","type":"text","marks":[{"type":"code"}]},{"text":". An optional header can supply a configuration object as a serialized JSON string:","type":"text"}]},{"type":"codeBlock","content":[{"text":"X-App-Config: ","type":"text"}]},{"type":"paragraph","content":[{"text":"The application's content is the body of the request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"Invoke the same command to update an application to a newer version. However, be sure to stop all of its Spark and MapReduce programs before updating the application.","type":"text"}]},{"type":"paragraph","content":[{"text":"For an application that has a configuration class s","type":"text"},{"text":"uch as:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"55240634-cfb8-44af-a8a2-acd3ed541c2a"}}]}]},{"type":"codeBlock","content":[{"text":"public static class MyAppConfig extends Config {\n String datasetName;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"We can deploy it with this call:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps\n-H \"X-Archive-Name: \" \\\n-H \"X-Principal: \" \\\n-H \"X-App-Deploy-Update-Schedules: true\" \\","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" The ","type":"text"},{"text":"X-App-Config","type":"text","marks":[{"type":"code"}]},{"text":" header contains the JSON serialization string of the ","type":"text"},{"text":"MyAppConfig","type":"text","marks":[{"type":"code"}]},{"text":" object.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List Applications","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"93908459-bf97-4283-baed-4edaccab5bff"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"1ff33a9a-8627-423b-bc8d-ac0e7596b17d"}}]}]},{"type":"paragraph","content":[{"text":"To list all of the applications in the namespace ","type":"text"},{"text":"namespace-id","type":"text","marks":[{"type":"code"}]},{"text":", issue a","type":"text"},{"text":"n ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"303d8a88-7daf-4a4e-b364-2e221df8dd0b"}}]},{"text":"HTTP GET ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"9ba25955-9a35-453b-b323-824735d48cb2"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"303d8a88-7daf-4a4e-b364-2e221df8dd0b"}}]},{"text":"request","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"a0a50868-e650-4b99-8208-bfc773d799c3"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"303d8a88-7daf-4a4e-b364-2e221df8dd0b"}}]},{"text":":","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"9ba25955-9a35-453b-b323-824735d48cb2"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"303d8a88-7daf-4a4e-b364-2e221df8dd0b"}}]}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps[?\n[artifactName=]\n[&artifactVersion=]\n[&pageSize=]\n[&pageToken=]\n[&orderBy=]\n[&nameFilter=]\n[&nameFilterType=]\n[&sortCreationTime=]\n[&latestOnly=]]","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b30240ac-4e95-4489-948c-8c7a87868297"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"Version Introduced","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"artifactName","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter to list all applications that use the specified artifact name. Valid values are ","type":"text"},{"text":"cdap-data-pipeline","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"cdap-data-streams","type":"text","marks":[{"type":"code"}]},{"text":", and ","type":"text"},{"text":"delta-app","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"artifactVersion","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"3a32c9e8-6182-4278-870b-46f76a19e43d"}}]},{"text":" This is the version of the artifact given in the ","type":"text"},{"text":"artifactName","type":"text","marks":[{"type":"code"}]},{"text":" parameter. It will be different depending on the artifact given. To get the version list, use Artifact Microservices.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"pageSize","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"6.6.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter. ","type":"text"},{"text":"The number of pipelines to be returned in the response. If ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b1e31048-19f7-47b4-9ce2-b7a055fb6620"}}]},{"text":"pageSize","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b1e31048-19f7-47b4-9ce2-b7a055fb6620"}},{"type":"code"}]},{"text":" is not specified, all pipelines will be returned. ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b1e31048-19f7-47b4-9ce2-b7a055fb6620"}}]},{"text":" ","type":"text"},{"text":"Basically, ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2ec5f50f-69ef-4155-81f2-90315a8ef5fa"}}]},{"text":"pageSize","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2ec5f50f-69ef-4155-81f2-90315a8ef5fa"}},{"type":"code"}]},{"text":" enables pagination of the results.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2ec5f50f-69ef-4155-81f2-90315a8ef5fa"}}]},{"text":" Using this parameter changes the result format. For details, see the examples that follow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"pageToken","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"6.6.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter. If ","type":"text"},{"text":"pageSize","type":"text","marks":[{"type":"code"}]},{"text":" is specified, use ","type":"text"},{"text":"nextPageToken","type":"text","marks":[{"type":"code"}]},{"text":" as the value from the response. If ","type":"text"},{"text":"pageToken","type":"text","marks":[{"type":"code"}]},{"text":" is not specified, returns the first page.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"orderBy","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"6.6.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter. ","type":"text"},{"text":"Specifies the sorting order.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e99fb735-6926-48b4-9794-f27eb35b7556"}}]},{"text":" The sorting is by Application Name and then Application Version.","type":"text"}]},{"type":"paragraph","content":[{"text":"Values can be ","type":"text"},{"text":"ASC","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"261d9367-c294-470d-a818-110e4f0cd5f0"}},{"type":"code"}]},{"text":"or ","type":"text"},{"text":"DESC","type":"text","marks":[{"type":"code"}]},{"text":". If unspecified, the value will be ","type":"text"},{"text":"ASC","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"},{"text":"ASC","type":"text","marks":[{"type":"code"}]},{"text":" stands for ascending order whereas ","type":"text"},{"text":"DESC","type":"text","marks":[{"type":"code"}]},{"text":" stands for descending order.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"nameFilter","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"6.8.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter. Filters the application name based on ","type":"text"},{"text":"nameFilterType","type":"text","marks":[{"type":"code"}]},{"text":". If ","type":"text"},{"text":"nameFilterType","type":"text","marks":[{"type":"code"}]},{"text":" is not set, it will use default ","type":"text"},{"text":"CONTAINS","type":"text","marks":[{"type":"code"}]},{"text":" type.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"nameFilterType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"6.8.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter. Values can be ","type":"text"},{"text":"EQUALS","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"CONTAINS","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"EQUALS_IGNORE_CASE","type":"text","marks":[{"type":"code"}]},{"text":". Specifies the way to filter application names based on ","type":"text"},{"text":"nameFilter","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"EQUALS","type":"text","marks":[{"type":"code"}]},{"text":": Application name must be equal to the ","type":"text"},{"text":"nameFilter","type":"text","marks":[{"type":"code"}]},{"text":", case sensitive.","type":"text"}]},{"type":"paragraph","content":[{"text":"CONTAINS","type":"text","marks":[{"type":"code"}]},{"text":": Application name must contain the ","type":"text"},{"text":"nameFilter","type":"text","marks":[{"type":"code"}]},{"text":", case insensitive.","type":"text"}]},{"type":"paragraph","content":[{"text":"EQUALS_IGNORE_CASE","type":"text","marks":[{"type":"code"}]},{"text":": Application name must be equal to the ","type":"text"},{"text":"nameFilter","type":"text","marks":[{"type":"code"}]},{"text":", case insensitive.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"sortCreationTime","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"6.8.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional Boolean. Values can be ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the sorting order will be based on the creation time of the applications, instead of by Application Name and then Application Version.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default is ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"latestOnly","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[114.0]},"content":[{"type":"paragraph","content":[{"text":"6.8.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[475.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter. Values can be ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":"or ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", it returns all versions of the apps. If not specified, it will use a default true value, that only returns the latest version of the applications.","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note: ","type":"text","marks":[{"type":"strong"}]},{"text":"When upgrading the instance from versions < 6.8 to versions >= 6.8, it’s important to follow the “upgrade applications” process in order to have the UI properly render all existing applications.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"pageSize","type":"text","marks":[{"type":"code"}]},{"text":" is not specified, this returns an array of JSON Objects that lists each application with its name, description, and artifact. The list can optionally be filtered by one or more artifact names. It can also be filtered by artifact version. ","type":"text"},{"text":"For example:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"d114fd17-6332-4367-8daa-6ab1deb3ad2d"}}]}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps?\nartifactName=cdap-data-pipeline,cdap-data-streams,delta-app","type":"text"}]},{"type":"paragraph","content":[{"text":"will return all applications that use either the ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"62e77d58-cc5d-411d-97a2-79867ea2ce17"}}]},{"text":"cdap-data-pipeline","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"62e77d58-cc5d-411d-97a2-79867ea2ce17"}},{"type":"code"}]},{"text":",","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"62e77d58-cc5d-411d-97a2-79867ea2ce17"}}]},{"text":"cdap-data-streams","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"62e77d58-cc5d-411d-97a2-79867ea2ce17"}},{"type":"code"}]},{"text":",or ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"62e77d58-cc5d-411d-97a2-79867ea2ce17"}}]},{"text":"delta-app","type":"text","marks":[{"type":"code"}]},{"text":" artifacts.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"62e77d58-cc5d-411d-97a2-79867ea2ce17"}}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"The following is an example response when ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"44c6c87a-2db7-45f8-a109-eb382fdcff67"}}]},{"text":"pageSize","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"44c6c87a-2db7-45f8-a109-eb382fdcff67"}},{"type":"code"}]},{"text":" is not specified:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"44c6c87a-2db7-45f8-a109-eb382fdcff67"}}]}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"type\": \"App\",\n \"name\": \"POS_Sales_per_Region\",\n \"version\": \"1.0.0\",\n \"description\": \"Data Pipeline Application\",\n \"artifact\": {\n \"name\": \"cdap-data-pipeline\",\n \"version\": \"6.8.0\",\n \"scope\": \"SYSTEM\"\n },\n \"change\": {\n \"author\": \"joe\",\n \"creationTimeMillis\": 1668540944833,\n \"latest\": true\n }\n },\n {\n \"type\": \"App\",\n \"name\": \"POS_Sales_per_Country\",\n \"version\": \"1.0.0\",\n \"description\": \"Data Pipeline Application\",\n \"artifact\": {\n \"name\": \"cdap-data-pipeline\",\n \"version\": \"6.8.0\",\n \"scope\": \"SYSTEM\"\n },\n \"change\": {\n \"author\": \"joe\",\n \"creationTimeMillis\": 1668543617736,\n \"latest\": true\n }\n }\n]","type":"text"}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"pageSize","type":"text","marks":[{"type":"code"}]},{"text":" is specified, the result is a JSON object that returns the applications as a JSON array under the ","type":"text"},{"text":"applications","type":"text","marks":[{"type":"code"}]},{"text":" key. ","type":"text"},{"text":"The page token identifier for the next page of results is specified under ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"36196980-a108-410d-8d50-67e64ec19ab0"}}]},{"text":"nextPageToken","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"36196980-a108-410d-8d50-67e64ec19ab0"}},{"type":"code"}]},{"text":" key.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"36196980-a108-410d-8d50-67e64ec19ab0"}}]},{"text":" The absence of ","type":"text"},{"text":"nextPageToken","type":"text","marks":[{"type":"code"}]},{"text":" in the response denotes that it was the last page in the results.","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps?\nnamespaces/default/apps?pageSize=2&orderBy=ASC","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"applications\": [\n {\n \"type\": \"App\",\n \"name\": \"POS_Sales_per_Region\",\n \"version\": \"1.0.0\",\n \"description\": \"Data Pipeline Application\",\n \"artifact\": {\n \"name\": \"cdap-data-pipeline\",\n \"version\": \"6.8.0\",\n \"scope\": \"SYSTEM\"\n },\n \"change\": {\n \"author\": \"joe\",\n \"creationTimeMillis\": 1668540944833,\n \"latest\": true\n }\n },\n {\n \"type\": \"App\",\n \"name\": \"POS_Sales_per_Country\",\n \"version\": \"1.0.0\",\n \"description\": \"Data Pipeline Application\",\n \"artifact\": {\n \"name\": \"cdap-data-pipeline\",\n \"version\": \"6.8.0\",\n \"scope\": \"SYSTEM\"\n },\n \"change\": {\n \"author\": \"joe\",\n \"creationTimeMillis\": 1668543617736,\n \"latest\": true\n }\n }\n ],\n \"nextPageToken\": \"POS_Sales_per_Country\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Details of an Application","type":"text"}]},{"type":"paragraph","content":[{"text":"For detailed information on an application in a namespace ","type":"text"},{"text":"namespace-id","type":"text","marks":[{"type":"code"}]},{"text":", use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps/","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4091f642-6cba-4545-bdb4-edd1f43b91dc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application.","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" To get the creation time of an application and other types of metadata, see ","type":"text"},{"text":"Metadata Microservices","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCS/pages/477692187"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The information will be returned in the body of the response. It includes the name and description of the application; the artifact and datasets that it uses, all of its programs; and the Kerberos principal, if that was provided during the deployment. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": \"POS_Sales_per_Region\",\n \"appVersion\": \"-SNAPSHOT\",\n \"description\": \"Data Pipeline Application\",\n \"change\": {\n \"author\": \"joe\",\n \"creationTimeMillis\": 1668540944833,\n \"latest\": true\n },\n \"configuration\": \"{\\\"resources\\\":{\\\"memoryMB\\\":2048.0,\\\"virtualCores\\\":1.0},\\\"driverResources\\\":{\\\"memoryMB\\\":2048.0,\\\"virtualCores\\\":1.0},\\\"connections\\\":[{\\\"from\\\":\\\"GCS - POS Sales\\\",\\\"to\\\":\\\"Wrangler\\\"},{\\\"from\\\":\\\"Wrangler\\\",\\\"to\\\":\\\"GCS2\\\"}],\\\"comments\\\":[],\\\"postActions\\\":[],\\\"properties\\\":{},\\\"processTimingEnabled\\\":true,\\\"stageLoggingEnabled\\\":false,\\\"stages\\\":[{\\\"name\\\":\\\"GCS - POS Sales\\\",\\\"plugin\\\":{\\\"name\\\":\\\"GCSFile\\\",\\\"type\\\":\\\"batchsource\\\",\\\"label\\\":\\\"GCS - POS Sales\\\",\\\"artifact\\\":{\\\"name\\\":\\\"google-cloud\\\",\\\"version\\\":\\\"0.15.3\\\",\\\"scope\\\":\\\"SYSTEM\\\"},\\\"properties\\\":{\\\"project\\\":\\\"auto-detect\\\",\\\"format\\\":\\\"text\\\",\\\"skipHeader\\\":\\\"false\\\",\\\"serviceFilePath\\\":\\\"auto-detect\\\",\\\"filenameOnly\\\":\\\"false\\\",\\\"recursive\\\":\\\"false\\\",\\\"encrypted\\\":\\\"false\\\",\\\"schema\\\":\\\"{\\\\\\\"type\\\\\\\":\\\\\\\"record\\\\\\\",\\\\\\\"name\\\\\\\":\\\\\\\"etlSchemaBody\\\\\\\",\\\\\\\"fields\\\\\\\":[{\\\\\\\"name\\\\\\\":\\\\\\\"offset\\\\\\\",\\\\\\\"type\\\\\\\":\\\\\\\"long\\\\\\\"},{\\\\\\\"name\\\\\\\":\\\\\\\"body\\\\\\\",\\\\\\\"type\\\\\\\":\\\\\\\"string\\\\\\\"}]}\\\",\\\"referenceName\\\":\\\"pos-sales\\\",\\\"path\\\":\\\"gs://flat-files-1/POS-r01.txt\\\"}},\\\"outputSchema\\\":\\\"{\\\\\\\"type\\\\\\\":\\\\\\\"record\\\\\\\",\\\\\\\"name\\\\\\\":\\\\\\\"etlSchemaBody\\\\\\\",\\\\\\\"fields\\\\\\\":[{\\\\\\\"name\\\\\\\":\\\\\\\"offset\\\\\\\",\\\\\\\"type\\\\\\\":\\\\\\\"long\\\\\\\"},{\\\\\\\"name\\\\\\\":\\\\\\\"body\\\\\\\",\\\\\\\"type\\\\\\\":\\\\\\\"string\\\\\\\"}]}\\\",\\\"id\\\":\\\"GCS---POS-Sales\\\"},{\\\"name\\\":\\\"Wrangler\\\",\\\"plugin\\\":{\\\"name\\\":\\\"Wrangler\\\",\\\"type\\\":\\\"transform\\\",\\\"label\\\":\\\"Wrangler\\\",\\\"artifact\\\":{\\\"name\\\":\\\"wrangler-transform\\\",\\\"version\\\":\\\"4.2.3\\\",\\\"scope\\\":\\\"SYSTEM\\\"},\\\"properties\\\":{\\\"field\\\":\\\"*\\\",\\\"precondition\\\":\\\"false\\\",\\\"threshold\\\":\\\"1\\\",\\\"schema\\\":\\\"{\\\\\\\"type\\\\\\\":\\\\\\\"record\\\\\\\",\\\\\\\"name\\\\\\\":\\\\\\\"etlSchemaBody\\\\\\\",\\\\\\\"fields\\\\\\\":[{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Item_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"WM_Week\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Daily\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Whse_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Whse_Name\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Sales\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Cost\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Net_Ship_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Sales_Type\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Sales_Description\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Max_Shelf_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Specific_Retail\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Specific_Cost\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Current_HO_Retail\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]}]}\\\",\\\"workspaceId\\\":\\\"af95f757-a2d8-4efb-90b0-fad0ff2a543b\\\",\\\"directives\\\":\\\"parse-as-csv :body \\\\u0027,\\\\u0027 true\\\\ndrop body\\\"}},\\\"outputSchema\\\":\\\"{\\\\\\\"type\\\\\\\":\\\\\\\"record\\\\\\\",\\\\\\\"name\\\\\\\":\\\\\\\"etlSchemaBody\\\\\\\",\\\\\\\"fields\\\\\\\":[{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Item_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"WM_Week\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Daily\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Whse_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Whse_Name\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Sales\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Cost\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Net_Ship_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Sales_Type\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Sales_Description\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Max_Shelf_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Specific_Retail\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Specific_Cost\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Current_HO_Retail\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]}]}\\\",\\\"inputSchema\\\":[{\\\"name\\\":\\\"GCS - POS Sales\\\",\\\"schema\\\":\\\"{\\\\\\\"type\\\\\\\":\\\\\\\"record\\\\\\\",\\\\\\\"name\\\\\\\":\\\\\\\"etlSchemaBody\\\\\\\",\\\\\\\"fields\\\\\\\":[{\\\\\\\"name\\\\\\\":\\\\\\\"offset\\\\\\\",\\\\\\\"type\\\\\\\":\\\\\\\"long\\\\\\\"},{\\\\\\\"name\\\\\\\":\\\\\\\"body\\\\\\\",\\\\\\\"type\\\\\\\":\\\\\\\"string\\\\\\\"}]}\\\"}],\\\"id\\\":\\\"Wrangler\\\"},{\\\"name\\\":\\\"GCS2\\\",\\\"plugin\\\":{\\\"name\\\":\\\"GCS\\\",\\\"type\\\":\\\"batchsink\\\",\\\"label\\\":\\\"GCS2\\\",\\\"artifact\\\":{\\\"name\\\":\\\"google-cloud\\\",\\\"version\\\":\\\"0.15.3\\\",\\\"scope\\\":\\\"SYSTEM\\\"},\\\"properties\\\":{\\\"project\\\":\\\"auto-detect\\\",\\\"suffix\\\":\\\"yyyy-MM-dd-HH-mm\\\",\\\"format\\\":\\\"csv\\\",\\\"serviceFilePath\\\":\\\"auto-detect\\\",\\\"location\\\":\\\"us\\\",\\\"referenceName\\\":\\\"pos-sales-per-region\\\",\\\"path\\\":\\\"gs://flat-files-1\\\"}},\\\"inputSchema\\\":[{\\\"name\\\":\\\"Wrangler\\\",\\\"schema\\\":\\\"{\\\\\\\"type\\\\\\\":\\\\\\\"record\\\\\\\",\\\\\\\"name\\\\\\\":\\\\\\\"etlSchemaBody\\\\\\\",\\\\\\\"fields\\\\\\\":[{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Item_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"WM_Week\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Daily\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Whse_Nbr\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Whse_Name\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Sales\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"POS_Cost\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Net_Ship_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Sales_Type\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Sales_Description\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Max_Shelf_Qty\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Specific_Retail\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Store_Specific_Cost\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]},{\\\\\\\"name\\\\\\\":\\\\\\\"Current_HO_Retail\\\\\\\",\\\\\\\"type\\\\\\\":[\\\\\\\"string\\\\\\\",\\\\\\\"null\\\\\\\"]}]}\\\"}],\\\"id\\\":\\\"GCS2\\\"}],\\\"schedule\\\":\\\"0 * * * *\\\",\\\"engine\\\":\\\"spark\\\",\\\"numOfRecordsPreview\\\":100.0,\\\"description\\\":\\\"Data Pipeline Application\\\",\\\"maxConcurrentRuns\\\":1.0}\",\n \"datasets\": [],\n \"programs\": [\n {\n \"type\": \"Spark\",\n \"app\": \"POS_Sales_per_Region\",\n \"name\": \"phase-1\",\n \"description\": \"Sources 'GCS - POS Sales' to sinks 'GCS2'.\"\n },\n {\n \"type\": \"Workflow\",\n \"app\": \"POS_Sales_per_Region\",\n \"name\": \"DataPipelineWorkflow\",\n \"description\": \"Data Pipeline Workflow\"\n }\n ],\n \"plugins\": [\n {\n \"id\": \"GCS - POS Sales\",\n \"name\": \"GCSFile\",\n \"type\": \"batchsource\"\n },\n {\n \"id\": \"GCS2:csv\",\n \"name\": \"csv\",\n \"type\": \"validatingOutputFormat\"\n },\n {\n \"id\": \"GCS - POS Sales:text\",\n \"name\": \"text\",\n \"type\": \"validatingInputFormat\"\n },\n {\n \"id\": \"GCS2\",\n \"name\": \"GCS\",\n \"type\": \"batchsink\"\n },\n {\n \"id\": \"Wrangler\",\n \"name\": \"Wrangler\",\n \"type\": \"transform\"\n }\n ],\n \"artifact\": {\n \"name\": \"cdap-data-pipeline\",\n \"version\": \"6.8.0\",\n \"scope\": \"SYSTEM\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"HTTP Responses","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"dc58211b-e6f7-4929-83de-9aced5721a4c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"Status Codes","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"200 OK","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"The event successfully called the method, and the body contains the results","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Upgrade an Application","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e6616422-6316-4b46-bc62-52bc2ef9bb67"}}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Notes:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For all realtime pipelines, except pipelines created in CDAP 6.8.0 with a Kafka streaming source, upgrading realtime pipelines to use the latest version of application artifacts is not supported.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Back up all applications before performing the upgrade.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To get the name of the application you want to upgrade, use the GET request listed in “List Applications”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If upgrading the instance from versions < 6.8 to versions >= 6.8, it’s important to set ","type":"text"},{"text":"latestOnly=false","type":"text","marks":[{"type":"code"}]},{"text":" for the above GET request.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"To upgrade an application in a namespace to use the latest version of application artifacts and plugin artifacts, run the following POST ","type":"text"},{"text":"request:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"33e4f8c6-bc32-4837-937a-15d71cf72e30"}}]}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//upgrade","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"096e8e48-efb4-41e1-b503-e180d81ce353"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"artifactScope","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Optional scope filter. If not specified, artifacts in the ","type":"text"},{"text":"USER","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"SYSTEM","type":"text","marks":[{"type":"code"}]},{"text":" scopes are upgraded. Otherwise, only artifacts in the specified scope are upgraded.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"allowSnapshot","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter to allow SNAPSHOT version of artifacts for upgrade. Set to TRUE to allow SNAPSHOT version of artifacts for upgrade. Set to FALSE to ignore SNAPSHOT version of artifacts for upgrade.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default is false.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will contain a list of application details containing name, application version, namespace, and entity. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/apps/purchaseWordCount/upgrade\n{\n \"statusCode\": 200,\n \"appId\": {\n \"application\": \"purchaseWordCount\",\n \"version\": \"-SNAPSHOT\",\n \"namespace\": \"default\",\n \"entity\": \"APPLICATION\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Upgrade a List of Applications","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"1c65d9b9-bf8e-403b-9b27-079e8608a504"}},{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"4b68814e-3ffc-4f6d-a79c-15a8a18aef64"}}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Notes:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrading real-time pipelines to use the latest version of application artifacts is not supported.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Back up all applications before performing the upgrade.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To get a list of all the application you want to upgrade to use the latest version of application artifacts and artifact plugins, use the GET request listed in “Details of a List of Applications”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If upgrading the instance from versions < 6.8 to versions >= 6.8, it’s important to set ","type":"text"},{"text":"latestOnly=false","type":"text","marks":[{"type":"code"}]},{"text":" for the above GET request.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"To upgrade a list of existing applications in a namespace to use the latest version of application artifacts and plugin artifacts, run the following POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//upgrade","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e078e62e-63ec-4fb7-b096-90e4bc7d42a6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"artifactScope","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter to allow artifacts of scope USER and SYSTEM for upgrade. Leave blank to allow artifacts of scope USER and SYSTEM for upgrade.","type":"text"}]},{"type":"paragraph","content":[{"text":"Optional scope filter. If not specified, artifacts in the ","type":"text"},{"text":"USER","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"SYSTEM","type":"text","marks":[{"type":"code"}]},{"text":" scopes are upgraded. Otherwise, only artifacts in the specified scope are upgraded.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"allowSnapshot","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Optional filter to allow SNAPSHOT version of artifacts for upgrade. Set to TRUE to allow SNAPSHOT version of artifacts for upgrade. Set to FALSE to ignore SNAPSHOT version of artifacts for upgrade.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default is false.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body is a JSON object specifying the updated artifact version and the updated application config. ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"be7792e3-7cfd-4cfd-9d53-8741d3281e4d"}}]}]},{"type":"paragraph","content":[{"text":"For example, the following request body will upgrade the listed applications in the default namespace to use the latest version of application artifacts and plugin artifacts.","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/upgrade\n[\n { \n \"type\": \"App\",\n \"name\": \"POS_Sales_per_Region\",\n \"version\": \"-SNAPSHOT\",\n \"description\": \"POS Sales per Region\",\n \"artifact\": {\n \"name\": \"cdap-data-pipeline\",\n \"version\": \"6.7.2\",\n \"scope\": \"SYSTEM\"\n }\n { \n \"type\": \"App\",\n \"name\": \"POS_Daily_Sales_per_Region\",\n \"version\": \"-SNAPSHOT\",\n \"description\": \"POS Daily Sales per Region\",\n \"artifact\": {\n \"name\": \"cdap-data-pipeline\",\n \"version\": \"6.7.2\",\n \"scope\": \"SYSTEM\"\n }\n } \n]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List Versions of an Application","type":"text"}]},{"type":"paragraph","content":[{"text":"To list all the versions of an application, submit an HTTP GET:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//versions","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4cf21d90-c19d-4eb4-9870-79b70f3d2172"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing details about the application. The details returned depend on the application.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, depending on the versions deployed:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces/default/apps/SportResults/versions","type":"text"}]},{"type":"paragraph","content":[{"text":"could return in a JSON array a list of the versions of the ","type":"text"},{"text":"application","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"f419fd07-ede8-4359-a963-f5bcc08b22c5"}}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\"1.0.1\", \"2.0.3\"]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delete an Application","type":"text"}]},{"type":"paragraph","content":[{"text":"To delete an application, together with all of its MapReduce or Spark programs, schedules, custom services, and workflows, submit an HTTP DELETE:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DELETE /v3/namespaces//apps/","type":"text"}]},{"type":"paragraph","content":[{"text":"(DEPRECATED) To delete a specific version of an application, submit an HTTP DELETE that includes the version:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DELETE /v3/namespaces//apps//versions/","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"24d3c146-621f-4fa5-8886-ab58df2d7bc0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[538.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[538.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[538.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application to be deleted","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[222.0]},"content":[{"type":"paragraph","content":[{"text":"version-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[538.0]},"content":[{"type":"paragraph","content":[{"text":"(DEPRECATED) Version of the application to be deleted","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" The ","type":"text"},{"text":"app-id","type":"text","marks":[{"type":"code"}]},{"text":" in this URL is the name of the application as configured by the application specification, and not necessarily the same as the name of the JAR file that was used to deploy the application.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This does not delete the datasets associated with the application because they belong to the namespace, not the application. Also, this does not delete the artifact used to create the application.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delete All Applications","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"6c3fb0e4-c28f-4383-b308-16bce092d891"}}]}]},{"type":"paragraph","content":[{"text":"To delete all the applications in a namespace, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DELETE /v3/namespaces//apps","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Export All Application Details","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"dec60aee-26ea-4991-b90d-671c92370c80"}}]}]},{"type":"paragraph","content":[{"text":"If you’re running Windows, you can export all application","type":"text"},{"text":" details ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"6edf32cf-95ab-476c-b9dd-01f1f585451c"}}]},{"text":"for all namespaces as a ZIP archive file, with the following request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/export/apps","type":"text"}]},{"type":"paragraph","content":[{"text":"If you’re running Linux or Mac, you can use the curl command to get the output and write it to file using the command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl http://localhost:11015/v3/export/apps > outfile.zip","type":"text"}]},{"type":"paragraph","content":[{"text":"If you’re running Windows and have powershell, you can use this command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"powershell -c Invoke-WebRequest http://localhost:11015/v3/export/apps -OutFile ./outfile.zip","type":"text"}]},{"type":"paragraph","content":[{"text":"These commands create a folder with the name of the zip file and write the contents to a file called outfile.zip in the directory you ran the command from. output.zip contains the JSON files for all of the applications in all namespaces in the CDAP instance.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delete a Streaming Application State (6.9.1+)","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"7d8ddea3-9ab2-487f-aeba-d31028707b18"}}]}]},{"type":"paragraph","content":[{"text":"To delete a streaming application state, submit an HTTP DELETE:","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE namespaces//apps//state","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"eb8f9e95-c24a-4484-b115-897466dca944"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace name.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"app-name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application with the state to be deleted.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"You might use this endpoint after you upgrade a CDAP instance or stop a streaming pipeline to delete the state for the last processed record.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Note: ","type":"text","marks":[{"type":"strong"}]},{"text":"This endpoint is supported for Kafka Consumer Streaming and Google Cloud Pub/Sub Streaming sources.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Program Lifecycle","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Details of a Program","type":"text"}]},{"type":"paragraph","content":[{"text":"After an application is deployed, you can retrieve the details of its MapReduce and Spark programs, custom services, schedules, workers, and workflows by submitting an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps///","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve information about the schedules of the program's workflows, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workflows//schedules","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"527b75fa-9a64-495d-bc94-ae5aca8324f9"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"workflow-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called, when retrieving schedules","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing details about the program. The details returned depend on the program type.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces/default/apps/SportResults/services/UploadService","type":"text"}]},{"type":"paragraph","content":[{"text":"will return in a JSON array information about the ","type":"text"},{"text":"UploadService","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"SportResults","type":"text","marks":[{"type":"em"}]},{"text":". The results will be similar to this (pretty-printed and portions deleted to fit):","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"className\": \"io.cdap.cdap.examples.sportresults.UploadService\",\n \"description\": \"A service for uploading sport results for a given league and season.\",\n \"handlers\": {\n \"UploadHandler\": {\n \"className\": \"io.cdap.cdap.examples.sportresults.UploadService$UploadHandler\",\n \"datasets\": [\n \"results\"\n ],\n \"description\": \"\",\n \"endpoints\": [\n {\n \"method\": \"PUT\",\n \"path\": \"/leagues/{league}/seasons/{season}\"\n },\n ...\n ],\n \"name\": \"UploadHandler\",\n \"plugins\": {},\n \"properties\": {}\n }\n },\n \"instances\": 1,\n \"name\": \"UploadService\",\n \"plugins\": {},\n \"resources\": {\n \"memoryMB\": 512,\n \"virtualCores\": 1\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"MapReduce","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"71d6894a-c181-4dbc-9719-92e651593707"}}]},{"text":" Jobs Associated with a Namespace (Deprecated)","type":"text"}]},{"type":"paragraph","content":[{"text":"To get a list of MapReduce jobs associated with a namespace, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//mapreduce","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"049c53c5-3a35-4a76-9183-17507a76a950"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing details about the MapReduce program:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"5684ca2f-4b0d-4523-9ed0-b0db175a2e42"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"app","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"f2b60378-7e0b-4d6b-83f9-b7dbc81ae3eb"}},{"type":"code"}]},{"text":"-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description of the program","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Spark Jobs Associated with a Namespace","type":"text"}]},{"type":"paragraph","content":[{"text":"To get a list of Spark jobs associated with a namespace, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//spark","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4b757e2a-6d77-45a5-a38e-8a1e5ccf3852"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing details about the Spark program:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c029e363-af82-4ca3-87e3-2ef533071395"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description of the program","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflows Associated with a Namespace","type":"text"}]},{"type":"paragraph","content":[{"text":"To get a list of workflows associated with a namespace, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//workflows","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d78fac9b-57d6-43f8-be61-eea0b8258ff0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing details about the workflows:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"27597e80-36e0-42e3-8d81-fcbe0692856d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description of the program","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Services Associated with a Namespace","type":"text"}]},{"type":"paragraph","content":[{"text":"To get a list of services associated with a namespace, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//services","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0a8ca82c-535c-4fa2-8352-f4c4c61447db"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing details about the services:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"059a7bc3-5993-42da-b713-11b3baa24e1b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description of the program","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workers Associated with a Namespace","type":"text"}]},{"type":"paragraph","content":[{"text":"To get a list of workers associated with a namespace, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//workers","type":"text"}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing details about the workers:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2b0e1173-e84b-4d42-adfc-5041b1356727"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description of the program","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Spark program status for an application","type":"text"}]},{"type":"paragraph","content":[{"text":"To check if a Spark program is available for an application, use:","type":"text"}]},{"type":"paragraph","content":[{"text":"GET /v3/namespaces//apps/{app-name}/spark/{program-name}/available","type":"text","marks":[{"type":"code"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"afb8a260-3c80-48b7-b594-1bb53922213e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"app-name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"program-name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the program.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Start a Program","type":"text"}]},{"type":"paragraph","content":[{"text":"After an application is deployed, you can start its MapReduce and Spark programs, custom services, workers, or workflows by submitting an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps////start","type":"text"}]},{"type":"paragraph","content":[{"text":"You can start a program of a particular version of the application by submitting an HTTP POST request that includes the version:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//versions////start","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" Concurrent runs of workers across multiple versions of the same application are not allowed.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"When starting a program, you can optionally specify runtime arguments as a JSON map in the request body. CDAP will use these runtime arguments only for this single invocation of the program.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0d2e8377-8313-41c7-a2dc-75e88c32b40e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"version-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"Version of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", and ","type":"text"},{"text":"Worker","type":"text","marks":[{"type":"em"}]},{"text":" programs do not allow concurrent program runs. Programs of these types cannot be started unless the program is in the ","type":"text"},{"text":"STOPPED","type":"text","marks":[{"type":"em"}]},{"text":" state. ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Workflow","type":"text","marks":[{"type":"em"}]},{"text":" programs support concurrent runs. If you start one of these programs, a new run will be started even if other runs of the program have not finished yet.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"29a4e805-7c69-4178-9c2e-cf7f173a0a26"}}]}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/apps/SportResults/services/UploadService/start \n'{ \"foo\":\"bar\", \"this\":\"that\" }'","type":"text"}]},{"type":"paragraph","content":[{"text":"will start the ","type":"text"},{"text":"UploadService","type":"text","marks":[{"type":"em"}]},{"text":" of the ","type":"text"},{"text":"SportResults","type":"text","marks":[{"type":"em"}]},{"text":" application with two runtime arguments.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Start Multiple Programs","type":"text"}]},{"type":"paragraph","content":[{"text":"You can start multiple programs from different applications and program types by submitting an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//start","type":"text"}]},{"type":"paragraph","content":[{"text":"with a JSON array in the request body consisting of multiple JSON objects with these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e44e90f8-88aa-4d8d-8b5c-f577d1f17ee4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[518.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[518.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[518.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[518.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being started","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"runtimeargs","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[518.0]},"content":[{"type":"paragraph","content":[{"text":"Optional JSON object containing a string to string mapping of runtime arguments to start the program with","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing a JSON object for each object in the input. Each JSON object will contain these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"29e9be40-68f7-4aeb-a05c-71db0898177f"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being started","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from starting an individual JSON object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the program could not be started (for example, the specified program was not found)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"runId","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"A UUID that uniquely identifies a run with CDAP","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"cc9b849b-249e-4fb1-8ce1-2ba8ba29c449"}}]}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/start\n [\n {\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\"},\n {\"appId\": \"App1\", \"programType\": \"Spark\", \"programId\": \"Spark2\"},\n {\"appId\": \"App2\", \"programType\": \"Spark\", \"programId\": \"Spark1\", \"runtimeargs\": { \"arg1\":\"val1\" }}\n ]'","type":"text"}]},{"type":"paragraph","content":[{"text":"will attempt to start the three programs listed in the request body. It will return a response such as:","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n {\"appId\": \"App1\", \"runId\":\"5f55fa1a-5700-11ed-a5d2-76b189bf0786\", \"programType\": \"Service\", \"programId\": \"Service1\", \"statusCode\": 200},\n {\"appId\": \"App1\", \"runId\":\"5f55fa1a-5700-11ed-a5d2-76b189bf0786\", \"programType\": \"Spark\", \"programId\": \"Spark2\", \"statusCode\": 200},\n {\"appId\": \"App2\", \"runId\":\"5f55fa1a-5700-11ed-a5d2-76b189bf0786\", \"programType\":\"Spark\", \"programId\":\"Spark1\", \"statusCode\":404, \"error\": \"App: App2 not found\"}\n]","type":"text"}]},{"type":"paragraph","content":[{"text":"In this particular example, the service and Spark programs in the ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":" application were successfully started, and there was an error starting the last program because the ","type":"text"},{"text":"App2","type":"text","marks":[{"type":"em"}]},{"text":" application does not exist.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Stop a Program","type":"text"}]},{"type":"paragraph","content":[{"text":"You can stop the MapReduce and Spark programs, custom services, workers, and workflows of an application by submitting an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps////stop","type":"text"}]},{"type":"paragraph","content":[{"text":"You can stop the programs of a particular application version by submitting an HTTP POST request that includes the version:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//versions////stop","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"51ece419-0392-46c3-acd8-e829d8662c17"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"version-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Version of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[233.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being stopped","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"A program that is in the STOPPED state cannot be stopped. If there are multiple runs of the program in the RUNNING state, this call will stop one of the runs, but not all of the runs.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/apps/SportResults/services/UploadService/stop","type":"text"}]},{"type":"paragraph","content":[{"text":"will stop the ","type":"text"},{"text":"UploadService","type":"text","marks":[{"type":"em"}]},{"text":" service in the ","type":"text"},{"text":"SportResults","type":"text","marks":[{"type":"em"}]},{"text":" application.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Stop a Program Run","type":"text"}]},{"type":"paragraph","content":[{"text":"You can stop a specific run of a program by submitting an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps////runs//stop","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"3955c4d0-2a32-4c3a-a02e-d1f57f865678"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[504.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[504.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[504.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[504.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[504.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"run-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[504.0]},"content":[{"type":"paragraph","content":[{"text":"Run id of the run being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/apps/PurchaseHistory/mapreduce/PurchaseHistoryBuilder/runs/631bc459-a9dd-4218-9ea0-d46fb1991f82/stop","type":"text"}]},{"type":"paragraph","content":[{"text":"will stop a specific run of the ","type":"text"},{"text":"PurchaseHistoryBuilder","type":"text","marks":[{"type":"em"}]},{"text":" MapReduce program in the ","type":"text"},{"text":"PurchaseHistory","type":"text","marks":[{"type":"em"}]},{"text":" application.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Stop Multiple Programs","type":"text"}]},{"type":"paragraph","content":[{"text":"You can stop multiple programs from different applications and program types by submitting an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//stop","type":"text"}]},{"type":"paragraph","content":[{"text":"with a JSON array in the request body consisting of multiple JSON objects with these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a4382bd7-3537-4e53-9e4a-468490901874"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being stopped","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing a JSON object corresponding to each object in the input. Each JSON object will contain these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"7ac45c7c-2095-477a-9f47-6d740bc83f9a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being stopped","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from stopping an individual JSON object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[241.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the program could not be stopped (for example, the specified program was not found)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"6545851d-c5c6-4776-b501-bb6d489cdd7b"}}]}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/stop\n [\n {\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\"},\n {\"appId\": \"App1\", \"programType\": \"Mapreduce\", \"programId\": \"MapReduce2\"},\n {\"appId\": \"App2\", \"programType\": \"Spark\", \"programId\": \"Spark2\"}\n ]'","type":"text"}]},{"type":"paragraph","content":[{"text":"will attempt to stop the three programs listed in the request body. It will return a response such as:","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n {\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\", \"statusCode\": 200},\n {\"appId\": \"App1\", \"programType\": \"Mapreduce\", \"programId\": \"Mapreduce2\", \"statusCode\": 200},\n {\"appId\": \"App2\", \"programType\":\"Spark\", \"programId\":\"Spark1\", \"statusCode\":404, \"error\": \"App: App2 not found\"}\n]","type":"text"}]},{"type":"paragraph","content":[{"text":"In this particular example, the service and MapReduce programs in the ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":" application were successfully stopped, and there was an error starting the last program because the ","type":"text"},{"text":"App2","type":"text","marks":[{"type":"em"}]},{"text":" application does not exist.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Status of a Program","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve the status of a program, submit an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps////status","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"46ced4e7-5fa1-4525-bd0d-501d24048277"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"schedules","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[237.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"schedule","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array with status of the program. For example, retrieving the status of the ","type":"text"},{"text":"UploadService","type":"text","marks":[{"type":"em"}]},{"text":" of the program ","type":"text"},{"text":"SportResults","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces/default/apps/SportResults/services/UploadService/status","type":"text"}]},{"type":"paragraph","content":[{"text":"will return (pretty-printed) a response such as:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"status\": \"STOPPED\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Status of Multiple Programs","type":"text"}]},{"type":"paragraph","content":[{"text":"You can retrieve the status of multiple programs from different applications and program types by submitting an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//status","type":"text"}]},{"type":"paragraph","content":[{"text":"with a JSON array in the request body consisting of multiple JSON objects with these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"27068631-d487-4742-b8e7-a3ef32496313"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[225.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[535.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[225.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[535.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[225.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[535.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"schedule","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[225.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[535.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"schedule","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be the same JSON array as submitted with additional parameters for each of the underlying JSON objects:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"f0b1e923-f5ca-408d-888c-002a403d57c3"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"Maps to the status of an individual JSON object's queried program if the query is valid and the program was found","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from retrieving the status of an individual JSON object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the status was not retrieved (for example, the specified program was not found)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"status","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"error","type":"text","marks":[{"type":"code"}]},{"text":" fields are mutually exclusive meaning if there is an error, then there will never be a status and vice versa.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces/default/status -d '\n [\n { \"appId\": \"MyApp\", \"programType\": \"workflow\", \"programId\": \"MyWorkflow\" },\n { \"appId\": \"MyApp2\", \"programType\": \"service\", \"programId\": \"MyService\" }\n ]","type":"text"}]},{"type":"paragraph","content":[{"text":"will retrieve the status of two programs. It will return a response such as:","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n { \"appId\":\"MyApp\", \"programType\":\"workflow\", \"programId\":\"MyWorkflow\", \"status\":\"RUNNING\", \"statusCode\":200 },\n { \"appId\":\"MyApp2\", \"programType\":\"service\", \"programId\":\"MyService\", \"error\":\"Program not found\", \"statusCode\":404 }\n]","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Schedule Lifecycle","type":"text"}]},{"type":"paragraph","content":[{"text":"Schedules can only be created for ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2262255d-1814-4a0b-8e37-ef2da0a84545"}}]},{"text":"workflows","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCS/pages/480477416"}}]},{"text":". ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2262255d-1814-4a0b-8e37-ef2da0a84545"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add a Schedule","type":"text"}]},{"type":"paragraph","content":[{"text":"To add a schedule for a program to an application, submit an HTTP PUT request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"PUT /v3/namespaces//apps//schedules/","type":"text"}]},{"type":"paragraph","content":[{"text":"To add the schedule to an application with a non-default version, submit an HTTP PUT request with the version specified:","type":"text"}]},{"type":"codeBlock","content":[{"text":"PUT /v3/namespaces//apps//versions//schedules/","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"89cdf5c9-aba5-4a32-8376-f6447706f193"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[275.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[275.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[275.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[275.0]},"content":[{"type":"paragraph","content":[{"text":"schedule-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the schedule; it is unique to the application and, if specified, the application version","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[275.0]},"content":[{"type":"paragraph","content":[{"text":"version-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.0]},"content":[{"type":"paragraph","content":[{"text":"Version of the application, typically following ","type":"text"},{"text":"semantic versioning","type":"text","marks":[{"type":"link","attrs":{"href":"http://semver.org/"}}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body is a JSON object specifying the details of the schedule to be created:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\": \"\",\n \"description\": \"\",\n \"namespace\": \"\",\n \"application\": \"\",\n \"applicationVersion\": \"\",\n \"program\": {\n \"programName\": \"\",\n \"programType\": \"WORKFLOW\"\n },\n \"properties\": {\n \"\": \"\",\n ...\n },\n \"constraints\": [\n {\n \"type\": \"\",\n \"waitUntilMet\": ,\n ...\n },\n ...\n ],\n \"trigger\": {\n \"type\": \"\",\n ...\n },\n \"timeoutMillis\": \n}","type":"text"}]},{"type":"paragraph","content":[{"text":"where a trigger is one of the ","type":"text"},{"text":"trigger types","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCS/pages/480346341"}}]},{"text":". It can be a time trigger:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"type\": \"TIME\",\n \"cronExpression\": \"\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"or a partition trigger:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"type\": \"PARTITION\",\n \"dataset\": {\n \"namespace\": \"\",\n \"dataset\": \"\"\n },\n \"numPartitions\": \n}","type":"text"}]},{"type":"paragraph","content":[{"text":"or a program status trigger:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"programId\": {\n \"namespace\": \"\",\n \"application\": \"\",\n \"version\": \"\",\n \"type\": \"\",\n \"entity\": \"PROGRAM\",\n \"program\": \"\"\n },\n \"programStatuses\": [ , , ],\n \"type\": \"PROGRAM_STATUS\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"or an AND trigger, where \"triggers\" is a non-empty list of any type of triggers:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"triggers\" : [\n {\n \"type\": \"\",\n ...\n },\n ...\n ],\n \"type\": \"AND\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"or an OR trigger, where \"triggers\" is a non-empty list of any type of triggers:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"triggers\" : [\n {\n \"type\": \"\",\n ...\n },\n ...\n ],\n \"type\": \"OR\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"and a constraint can be one of:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"type\": \"CONCURRENCY\",\n \"maxConcurrency\": ,\n \"waitUntilMet\": \n}\n\n{\n \"type\": \"DELAY\",\n \"millisAfterTrigger\": ,\n \"waitUntilMet\": \n}\n\n{\n \"type\": \"TIME_RANGE\",\n \"startTime\": \"\",\n \"endTime\": \"\",\n \"timeZone\": \"\",\n \"waitUntilMet\": \n}\n\n{\n \"type\": \"LAST_RUN\",\n \"millisSinceLastRun\": ,\n \"waitUntilMet\": \n}","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" For any schedule, the program must be for a workflow and the ","type":"text"},{"text":"programType","type":"text","marks":[{"type":"code"}]},{"text":" must be set to ","type":"text"},{"text":"WORKLFLOW","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"HTTP Responses","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"148fc86d-470c-46f9-a538-bb669583e04c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"Status Codes","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"409 Conflict","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Schedule with the same name already exists","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Update a Schedule","type":"text"}]},{"type":"paragraph","content":[{"text":"To update a schedule, submit an HTTP POST request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//schedules//update","type":"text"}]},{"type":"paragraph","content":[{"text":"To update a schedule of an application with a non-default version, submit an HTTP POST request with the version specified:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//versions//schedules//update","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c2e83cf1-178b-46a0-896f-bb9a6ec094ad"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"schedule-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the schedule; it is unique to the application and, if specified, the application version.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"version-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Version of the application, typically following ","type":"text"},{"text":"semantic versioning","type":"text","marks":[{"type":"link","attrs":{"href":"http://semver.org/"}}]},{"text":".","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body is a JSON object specifying the details of the schedule to be updated, and follows the same form as documented in Add a Schedule.","type":"text"}]},{"type":"paragraph","content":[{"text":"Only changes to the schedule configurations are supported; changes to the schedule name, or to the program associated with it are not allowed. If ","type":"text"},{"text":"any","type":"text","marks":[{"type":"em"}]},{"text":" properties are provided, they will overwrite all existing properties with what is provided. You must include all properties, even ones you are are not altering.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"HTTP Responses","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"eb358c15-5740-4a7e-98fb-02bd836366c6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"Status Codes","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[481.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[279.0]},"content":[{"type":"paragraph","content":[{"text":"400 Bad Request","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[481.0]},"content":[{"type":"paragraph","content":[{"text":"If the new schedule type does not match the existing schedule type or there are other client errors","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieving a Schedule","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve a schedule in an application, submit an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//schedules/","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"3195693c-1cd4-4e9b-9ebd-893b87400da2"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"schedule-name","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the schedule","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will contain the schedule in the same form described in this topic in “Add a Schedule”.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List Schedules","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"0e2a4775-0418-45c9-90cf-2d468297643a"}}]}]},{"type":"paragraph","content":[{"text":"To list all of the schedules for an application, use an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//schedules","type":"text"}]},{"type":"paragraph","content":[{"text":"As schedules are created for a workflow, you can also list schedules for a workflow of an application. You can use the Details of a Deployed Application to obtain the workflows of an application.","type":"text"}]},{"type":"paragraph","content":[{"text":"Optionally, you can filter the schedules by ","type":"text"},{"text":"trigger type and schedule status","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"8a55a7bd-cee9-429c-b47e-689bd462f41b"}}]},{"text":" using the query parameters ","type":"text"},{"text":"trigger-type","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"schedule-status","type":"text","marks":[{"type":"code"}]},{"text":". For more information, see ","type":"text"},{"text":"Schedules","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCS/pages/480346341"}}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"To list all of the schedules of a workflow of an application, use an HTTP GET request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workflows//schedules","type":"text"}]},{"type":"paragraph","content":[{"text":"The response will contain a list of schedules in the same form as described in “Add a Schedule”.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b737d2cc-778e-448d-811f-4b1d9152605f"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[251.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[251.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[251.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[251.0]},"content":[{"type":"paragraph","content":[{"text":"workflow-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[509.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the workflow","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Next Scheduled Run Time","type":"text"}]},{"type":"paragraph","content":[{"text":"To list the next time that the workflow will be be scheduled by a time trigger, use the parameter ","type":"text"},{"text":"nextruntime","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workflows//nextruntime","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"81b7b59f-3a08-4869-94bd-9eb72ae7561d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[521.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[521.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[521.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"workflow-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[521.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the workflow","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: Retrieving The Next Runtime","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c6a2e66c-d787-4e0e-be5f-814d8a617dcc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[489.0]},"content":[{"type":"paragraph","content":[{"text":"GET /v3/namespaces/default/apps/PurchaseHistory/workflows/PurchaseHistoryWorkflow/nextruntime","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[489.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"id\":\"DEFAULT.WORKFLOW:developer:PurchaseHistory:PurchaseHistoryWorkflow:0:DailySchedule\",\"time\":1415102400000}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[489.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieves the next runtime of the workflow ","type":"text"},{"text":"PurchaseHistoryWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"PurchaseHistory","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Next Scheduled Run Time in Batch","type":"text"}]},{"type":"paragraph","content":[{"text":"To list the next time that all workflows in a namespace will be be scheduled by a time trigger, use the parameter ","type":"text"},{"text":"nextruntime","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//nextruntime","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"fa25d48c-caf8-4091-b689-5381ff5002c4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[521.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[239.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[521.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body must be a JSON array of objects with the following parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d80ca2a6-5bfa-4d0e-a928-84a386538d78"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Currently, only the Workflow type is supported.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the program being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be an array of JSON Objects, each of which will contain the three input parameters as well as two of three possible extra fields: \"schedules\" or “error” if an error occurs.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4ba13c8e-552c-4073-b342-bcd515935bc6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"schedules","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"The next scheduled runtimes for the program defined by the individual JSON object's parameters","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from retrieving the program runs","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the status was not retrieved (for example, the specified program was not found, or the requested JSON object was missing a parameter)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"67087ebd-f14d-4653-9460-fa9bcc5465ab"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"POST /v3/namespaces/default/nextruntime","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Body","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\"}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"schedules\": [...]},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\", \"statusCode\": 404,","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"error\": \"Program 'testWorkflow' is not found\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"schedules\": [...]]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"Attempt to retrieve the next scheduled run of the service ","type":"text"},{"text":"Service1","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":", the workflow ","type":"text"},{"text":"testWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":" and the workflow ","type":"text"},{"text":"DataPipelineWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App2","type":"text","marks":[{"type":"em"}]},{"text":", all in the namespace ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Previous Run Time of All Schedules","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"ffc13d38-93e5-4f63-a6ce-5c0bdd2c1d06"}}]}]},{"type":"paragraph","content":[{"text":"To list the previous scheduled run time for all programs that are passed into the data, use the parameter ","type":"text"},{"text":"previousruntime","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//previousruntime","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"afeee322-ccbc-4141-afee-1821b8b995a7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body must be a JSON array of objects with the following parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"685a8aff-2401-433a-8d54-ad3523719f48"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Currently, only the Workflow type is supported.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the program being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be an array of JSON Objects, each of which will contain the three input parameters as well as two of three possible extra fields: \"schedules\" or “error” if an error occurs.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6e2d147f-a201-4455-aa80-06a69366c40a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"schedules","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"The previous scheduled runtimes for the program defined by the individual JSON object's parameters","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from retrieving the program runs","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the status was not retrieved (for example, the specified program was not found, or the requested JSON object was missing a parameter)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"84a6cb83-7f50-4bf8-9681-0156a860685c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"POST /v3/namespaces/default/previousruntime","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Body","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\"}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"schedules\": [...]},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\", \"statusCode\": 404,","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"error\": \"Program 'testWorkflow' is not found\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"schedules\": [...]]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"Attempt to retrieve the previous scheduled run of the service ","type":"text"},{"text":"Service1","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":", the workflow ","type":"text"},{"text":"testWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":" and the workflow ","type":"text"},{"text":"DataPipelineWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App2","type":"text","marks":[{"type":"em"}]},{"text":", all in the namespace ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Previous Run Time of a Schedule","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"6f8475d4-d9de-44d4-9908-79a4fa53c8f7"}}]}]},{"type":"paragraph","content":[{"text":"To list the previous runtime when the scheduled program ran, use the parameter ","type":"text"},{"text":"previousruntime","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workflows//previousruntime","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6373328f-e9e4-4491-9a88-e37fcee008a0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application to be deleted","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"workflow-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the Workflow","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4f53bae5-79e9-4a65-90da-23970b7bedf4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"GET /v3/namespaces/default/apps/PurchaseHistory/workflows/PurchaseHistoryWorkflow/previousruntime","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"id\":\"DEFAULT.WORKFLOW:developer:PurchaseHistory:PurchaseHistoryWorkflow:0:DailySchedule\",\"time\":1415102400000}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieves the previous runtime of the workflow ","type":"text"},{"text":"PurchaseHistoryWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"PurchaseHistory","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delete a Schedule","type":"text"}]},{"type":"paragraph","content":[{"text":"To delete a schedule, submit an HTTP DELETE:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DELETE /v3/namespaces//apps//schedules/","type":"text"}]},{"type":"paragraph","content":[{"text":"To delete a schedule of an application with a non-default version, submit an HTTP DELETE request with the version specified:","type":"text"}]},{"type":"codeBlock","content":[{"text":"DELETE /v3/namespaces//apps//versions//schedules/","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"8714d527-a956-4c63-953e-213c735b426b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application to be deleted","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"schedule-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the schedule; it is unique to the application and, if specified, the application version","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"version-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Version of the application to be deleted","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"HTTP Responses","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4a0fb237-6382-4769-96a5-af928d72d212"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"Status Codes","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"404 Bad Request","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"If the schedule given by ","type":"text"},{"text":"schedule-id","type":"text","marks":[{"type":"code"}]},{"text":" was not found","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Schedule: Disable and and Enable","type":"text"}]},{"type":"paragraph","content":[{"text":"For a schedule, you can disable and enable it using the Microservices.","type":"text"}]},{"type":"paragraph","content":[{"text":"Disable:","type":"text","marks":[{"type":"strong"}]},{"text":" To ","type":"text"},{"text":"disable","type":"text","marks":[{"type":"em"}]},{"text":" a schedule means that the program associated with that schedule will not trigger again until the schedule is enabled.","type":"text"}]},{"type":"paragraph","content":[{"text":"Enable:","type":"text","marks":[{"type":"strong"}]},{"text":" To ","type":"text"},{"text":"enable","type":"text","marks":[{"type":"em"}]},{"text":" a schedule means that the trigger is reset, and the program associated will run again at the next scheduled time.","type":"text"}]},{"type":"paragraph","content":[{"text":"As a schedule is initially deployed in a ","type":"text"},{"text":"disabled","type":"text","marks":[{"type":"em"}]},{"text":" state, a call to this API is needed to ","type":"text"},{"text":"enable","type":"text","marks":[{"type":"em"}]},{"text":" it.","type":"text"}]},{"type":"paragraph","content":[{"text":"To disable or enable a schedule, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//schedules//disable\nPOST /v3/namespaces//apps//schedules//enable","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note: ","type":"text","marks":[{"type":"strong"}]},{"text":"You can also use suspend and resume instead of disable and enable. ","type":"text"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"00d694ba-707b-4333-987f-1fdd9ffca260"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"schedule-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the schedule","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: Disabling a Schedule","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ec144399-c58a-451f-8913-b9e3720f0df8"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[297.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[463.0]},"content":[{"type":"paragraph","content":[{"text":"POST /v3/namespaces/default/apps/PurchaseHistory/schedules/DailySchedule/disable","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[297.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[463.0]},"content":[{"type":"paragraph","content":[{"text":"OK","type":"text","marks":[{"type":"code"}]},{"text":" if successfully set as disabled","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[297.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[463.0]},"content":[{"type":"paragraph","content":[{"text":"Disables the schedule ","type":"text"},{"text":"DailySchedule","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"PurchaseHistory","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Container Information","type":"text"}]},{"type":"paragraph","content":[{"text":"To find out the address of an program's container host and the container’s debug port, you can query CDAP for a service’s live info via an HTTP GET method:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps////live-info","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b63ba9c0-2d41-4994-aadc-ba60166c2e2e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"workers","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the program (","type":"text"},{"text":"service","type":"text","marks":[{"type":"em"}]},{"text":" or ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces/default/apps/WordCount/flows/WordCounter/live-info","type":"text"}]},{"type":"paragraph","content":[{"text":"The response is formatted in JSON; an example of this is shown in ","type":"text"},{"text":"CDAP Testing and Debugging","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCS/pages/480379435"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Scaling","type":"text"}]},{"type":"paragraph","content":[{"text":"You can retrieve the instance count executing different components from various applications and different program types using an HTTP POST method:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//instances","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"512a3279-68fa-4649-86e4-f9f3e4932925"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[223.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[223.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"with a JSON array in the request body consisting of multiple JSON objects with these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e0dc846d-ebc8-4184-b9b1-3297547eced8"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the program (","type":"text"},{"text":"service","type":"text","marks":[{"type":"em"}]},{"text":" or ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":") being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be the same JSON array as submitted with additional parameters for each of the underlying JSON objects:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"776493e2-b19b-4a0e-8896-78b534a73ced"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"requested","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"Number of instances the user requested for the program defined by the individual JSON object's parameters","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"provisioned","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"Number of instances that are actually running for the program defined by the individual JSON object's parameters.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from retrieving the instance count of an individual JSON object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[534.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the status was not retrieved (for example, the specified program was not found, or the requested JSON object was missing a parameter)","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" The ","type":"text"},{"text":"requested","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"provisioned","type":"text","marks":[{"type":"code"}]},{"text":" fields are mutually exclusive of the ","type":"text"},{"text":"error","type":"text","marks":[{"type":"code"}]},{"text":" field.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b9c70c5a-96cc-4d87-91bf-1a0d3d191c5b"}}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"cd9df5a1-99c6-4e83-9df9-2c5d31840f77"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"POST /v3/namespaces/default/instances","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Body","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\":\"MyApp1\",\"programType\":\"Worker\",\"programId\":\"MyWorker1\",}, {\"appId\":\"MyApp3\",\"programType\":\"Service\",\"programId\":\"MySvc1,}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\":\"MyApp1\",\"programType\":\"Worker\",\"programId\":\"MyWorker1\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"provisioned\":2,\"requested\":2,\"statusCode\":200},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\":\"MyApp3\",\"programType\":\"Service\",\"programId\":\"MySvc1,}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Attempt to retrieve the instances of programType Worker in the application ","type":"text"},{"text":"MyApp1","type":"text","marks":[{"type":"em"}]},{"text":", and the service handler ","type":"text"},{"text":"MyHandler1","type":"text","marks":[{"type":"em"}]},{"text":" in the user service ","type":"text"},{"text":"MySvc1","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"MyApp3","type":"text","marks":[{"type":"em"}]},{"text":", all in the namespace ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scaling Services","type":"text"}]},{"type":"paragraph","content":[{"text":"You can query or change the number of instances of a service by using the ","type":"text"},{"text":"instances","type":"text","marks":[{"type":"code"}]},{"text":" parameter with HTTP GET or PUT methods:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//services//instances\nPUT /v3/namespaces//apps//services//instances","type":"text"}]},{"type":"paragraph","content":[{"text":"with the arguments as a JSON string in the body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{ \"instances\" : }","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"41fd5d96-fb12-49c3-9bdd-9aad601b17d3"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[265.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[495.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[265.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[495.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[265.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[495.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[265.0]},"content":[{"type":"paragraph","content":[{"text":"service-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[495.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the service","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[265.0]},"content":[{"type":"paragraph","content":[{"text":"quantity","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[495.0]},"content":[{"type":"paragraph","content":[{"text":"Number of instances to be used","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" You can scale system services using the Monitor HTTP RESTful API ","type":"text"},{"text":"Scaling System Services","type":"text","marks":[{"type":"link","attrs":{"href":"https://cdap.atlassian.net/wiki/spaces/DOCS/pages/477561034/Monitor+HTTP+RESTful+API"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Retrieve the number of instances of the service ","type":"text"},{"text":"CatalogLookup","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"PurchaseHistory","type":"text","marks":[{"type":"em"}]},{"text":" in the namespace ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces/default/apps/PurchaseHistory/services/CatalogLookup/instances","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the number of handler instances of the service ","type":"text"},{"text":"RetrieveCounts","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"WordCount","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"PUT /v3/namespaces/default/apps/WordCount/services/RetrieveCounts/instances","type":"text"}]},{"type":"paragraph","content":[{"text":"with the arguments as a JSON string in the body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{ \"instances\" : 2 }","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using ","type":"text"},{"text":"curl","type":"text","marks":[{"type":"code"}]},{"text":" and the ","type":"text"},{"text":"CDAP Sandbox","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCS/pages/480346167"}}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Linux","type":"text"},{"type":"hardBreak"},{"text":"$ curl -w\"\\n\" -X PUT \"http://localhost:11015/v3/namespaces/default/apps/WordCount/services/RetrieveCounts/instances\" \\ -d '{ \"instances\" : 2 }'","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows","type":"text"},{"type":"hardBreak"},{"text":"> curl -X PUT \"http://localhost:11015/v3/namespaces/default/apps/WordCount/services/RetrieveCounts/instances\" ^ -d \"{ \\\"instances\\\" : 2 }\"","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scaling Workers","type":"text"}]},{"type":"paragraph","content":[{"text":"You can query or change the number of instances of a worker by using the ","type":"text"},{"text":"instances","type":"text","marks":[{"type":"code"}]},{"text":" parameter with HTTP GET or PUT methods:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workers//instances\nPUT /v3/namespaces//apps//workers//instances","type":"text"}]},{"type":"paragraph","content":[{"text":"with the arguments as a JSON string in the body:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{ \"instances\" : }","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1d9f1a18-ddca-44d0-9f99-af1e2583f5bc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[283.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[477.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[283.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[477.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[283.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[477.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[283.0]},"content":[{"type":"paragraph","content":[{"text":"worker-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[477.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the worker","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[283.0]},"content":[{"type":"paragraph","content":[{"text":"quantity","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[477.0]},"content":[{"type":"paragraph","content":[{"text":"Number of instances to be used","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Retrieve the number of instances of the worker ","type":"text"},{"text":"DataWorker","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"DemoApp","type":"text","marks":[{"type":"em"}]},{"text":" in the namespace ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces/default/apps/DemoApp/workers/DataWorker/instances","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Run Records","type":"text"}]},{"type":"paragraph","content":[{"text":"To see all the runs of a selected program (MapReduce programs, Spark programs, services, or workflows), issue an HTTP GET to the program’s URL with the ","type":"text"},{"text":"runs","type":"text","marks":[{"type":"code"}]},{"text":" parameter. This will return a JSON list of all runs for the program, each with a start time, end time, and program status:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps////runs","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6f26f729-dc4f-4270-ba43-12f07ea1ce79"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"You can filter the runs by the status of a program, the start and end times, and can limit the number of returned records:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"98995255-eb12-4e73-a0b2-6326c1e91f01"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Query Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"PENDING","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"STARTING","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"RUNNING","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"STOPPING","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"COMPLETED","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"FAILED","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"KILLED","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"REJECTED","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"start timestamp","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"end","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"end timestamp","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"limit","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"maximum number of returned records","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing a JSON object for each object in the input. Each JSON object will contain these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a3f46240-3c36-4e2f-8b56-65b583526eab"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"run-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"A UUID that uniquely identifies a run within CDAP, with the start and end times in seconds since the start of the Epoch (midnight 1/1/1970). Use that ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}}]},{"text":"runid","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}},{"type":"code"}]},{"text":" in subsequent calls to obtain additional information.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"starting","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the program was requested to start by the user.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the program actually started.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"suspend","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which this run was suspended (if it was suspended).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"resume","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which this run was resumed (if it was resumed after being suspended).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"stopping","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the request to stop this run was made.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"terminate","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp after which the run will be forcefully killed if it does not stop gracefully.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The status of the run in question.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"A map of the properties of the run. Has subfields.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"properties.runtimeArgs","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The runtime arguments provided to the run serialized as a JSON string.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"provides information about the cluster on which the run was executed. Has subfields.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster.status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The current status of the cluster.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster.numNodes","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The number of nodes in the cluster.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The compute profile used for the run.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.profileName","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the compute profile.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.namespace","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The namespace of the compute profile.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.entity","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The profile’s entity type.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example: Retrieving Run Records","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"cedee19f-b9e4-47de-a390-589b8dbe254b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[456.0]},"content":[{"type":"paragraph","content":[{"text":"GET /v3/namespaces/default/apps/SportResults/mapreduce/ScoreCounter/runs","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[456.0]},"content":[{"type":"paragraph","content":[{"text":"{\"runid\":\"...\",\"start\":1382567598,\"status\":\"RUNNING\"},","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"{\"runid\":\"...\",\"start\":1382567447,\"end\":1382567492,\"status\":\"STOPPED\"},","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"{\"runid\":\"...\",\"start\":1382567383,\"end\":1382567397,\"status\":\"STOPPED\"}","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[456.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieve the run records of the MapReduce ","type":"text"},{"text":"ScoreCounter","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"SportResults.","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieving Specific Run Information","type":"text"}]},{"type":"paragraph","content":[{"text":"To fetch the run record for a particular run of a program, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps////runs/","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ac67d012-b86d-45d2-a4ae-ca08a02f862d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"workflows","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the ","type":"text"},{"text":"MapReduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"custom service","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Spark","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":" being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"run-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[532.0]},"content":[{"type":"paragraph","content":[{"text":"Run id of the run","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be a JSON array containing a JSON object for each object in the input. Each JSON object will contain these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1b5b491c-d9f1-475a-b537-a22ed1f28459"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"run-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"A UUID that uniquely identifies a run within CDAP, with the start and end times in seconds since the start of the Epoch (midnight 1/1/1970). Use that ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}}]},{"text":"runid","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}},{"type":"code"}]},{"text":" in subsequent calls to obtain additional information.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"starting","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the program was requested to start by the user.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the program actually started.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"suspend","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which this run was suspended (if it was suspended).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"resume","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which this run was resumed (if it was resumed after being suspended).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"stopping","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the request to stop this run was made.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"terminate","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp after which the run will be forcefully killed if it does not stop gracefully.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The status of the run in question.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"A map of the properties of the run. Has subfields.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"properties.runtimeArgs","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The runtime arguments provided to the run serialized as a JSON string.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"provides information about the cluster on which the run was executed. Has subfields.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster.status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The current status of the cluster.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster.numNodes","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The number of nodes in the cluster.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The compute profile used for the run.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.profileName","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the compute profile.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.namespace","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The namespace of the compute profile.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.entity","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The profile’s entity type.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example: Retrieving a Particular Run Record","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c1a81633-fd29-4d01-8a1d-e6327db5c611"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[313.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[447.0]},"content":[{"type":"paragraph","content":[{"text":"GET /v3/namespaces/default/apps/SportResults/mapreduce/ScoreCounter/runs/b78d0091-da42-11e4-878c-2217c18f435d","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[313.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[447.0]},"content":[{"type":"paragraph","content":[{"text":"{\"runid\":\"...\",\"start\":1382567598,\"status\":\"RUNNING\"}","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[313.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[447.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieve the run record of the MapReduce ","type":"text"},{"text":"ScoreCounter","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"SportResults","type":"text","marks":[{"type":"em"}]},{"text":" run ","type":"text"},{"text":"b78d0091-da42-11e4-878c-2217c18f435d","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"For services, you can retrieve:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the history of successfully completed Apache Twill service runs using:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//services//runs?status=completed","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For workflows, you can retrieve:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the information about the currently running node(s) in the workflow:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workflows//runs//nodes/state","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"More information about workflow endpoint can be found at ","type":"text"},{"text":"Workflows","type":"text","marks":[{"type":"link","attrs":{"href":"https://cdap.atlassian.net/wiki/spaces/DOCS/pages/477790711/Workflow+HTTP+RESTful+API"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the schedules defined for a workflow (using the parameter ","type":"text"},{"text":"schedules","type":"text","marks":[{"type":"code"}]},{"text":"):","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workflows//schedules","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the next time that the workflow is scheduled to run (using the parameter ","type":"text"},{"text":"nextruntime","type":"text","marks":[{"type":"code"}]},{"text":"):","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps//workflows//nextruntime","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Example: Retrieving The Most Recent Run","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"00ce5cc0-c143-4eb3-9c6d-6c7c570f2bfc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[234.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"GET /v3/namespaces/default/apps/PurchaseHistory/services/CatalogLookup/runs?status=completed&limit=1","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[234.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"runid\":\"cad83d45-ecfb-4bf8-8cdb-4928a5601b0e\",\"start\":1415051892,\"end\":1415057103,\"status\":\"STOPPED\"}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[234.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieve the most recent successful completed run of the service ","type":"text"},{"text":"CatalogLookup","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"PurchaseHistory","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieving Run Records in Batch","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve the latest run records for run records for multiple programs, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//runs","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"72966666-fa11-4b4e-bfe0-ecfe8fb2d92b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[235.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[525.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[235.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[525.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body must be a JSON array of objects with the following parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"fee982fa-ef61-4706-9823-a11ac3736c07"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"run-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"A UUID that uniquely identifies a run within CDAP, with the start and end times in seconds since the start of the Epoch (midnight 1/1/1970). Use that ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}}]},{"text":"runid","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}},{"type":"code"}]},{"text":" in subsequent calls to obtain additional information.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b57fde78-e7ef-46b9-84d3-19b91481501f"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"starting","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the program was requested to start by the user.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the program actually started.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"suspend","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which this run was suspended (if it was suspended).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"resume","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which this run was resumed (if it was resumed after being suspended).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"stopping","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp at which the request to stop this run was made.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"terminate","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The timestamp after which the run will be forcefully killed if it does not stop gracefully.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The status of the run in question.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"A map of the properties of the run. Has subfields.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"properties.runtimeArgs","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The runtime arguments provided to the run serialized as a JSON string.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"provides information about the cluster on which the run was executed. Has subfields.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster.status","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The current status of the cluster.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"cluster.numNodes","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The number of nodes in the cluster.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The compute profile used for the run.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.profileName","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the compute profile.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.namespace","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The namespace of the compute profile.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"profile.entity","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The profile’s entity type.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be an array of JSON Objects, each of which will contain the three input parameters as well as two of three possible extra fields: ","type":"text"},{"text":"runs","type":"text","marks":[{"type":"code"}]},{"text":", which is a list of the latest run record for that program, ","type":"text"},{"text":"statusCode","type":"text","marks":[{"type":"code"}]},{"text":", which maps to the status code for retrieving the runs for that program, and ","type":"text"},{"text":"error","type":"text","marks":[{"type":"code"}]},{"text":" if there was an error retrieving runs for that program. The \"statusCode\" property will always be included, but ","type":"text"},{"text":"runs","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"error","type":"text","marks":[{"type":"code"}]},{"text":" are mutually exclusive.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ff2fe057-8ff7-48f9-8924-17df3248c2b9"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"runs","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"The latest run records for the program defined by the individual JSON object's parameters","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from retrieving the program runs","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[529.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the status was not retrieved (for example, the specified program was not found, or the requested JSON object was missing a parameter)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e4b571cc-7819-45b5-81b0-6dd354205448"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"POST /v3/namespaces/default/runs","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Body","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\"}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"runs\": [...]},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\", \"statusCode\": 404,","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"error\": \"Program 'testWorkflow' is not found\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"runs\": [...]]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[524.0]},"content":[{"type":"paragraph","content":[{"text":"Attempt to retrieve the latest run records of the service ","type":"text"},{"text":"Service1","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":", the workflow ","type":"text"},{"text":"testWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":" and the workflow ","type":"text"},{"text":"DataPipelineWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App2","type":"text","marks":[{"type":"em"}]},{"text":", all in the namespace ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieving Run Counts in Batch","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve the run counts for multiple programs, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//runcount","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"cba1dc20-7125-44f5-ae26-afe9bb7e54ac"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[240.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The request body must be a JSON array of objects with the following parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"423be2b5-5e2e-420d-b501-0a2b6d72af87"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"appId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application being called","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"programType","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[244.0]},"content":[{"type":"paragraph","content":[{"text":"programId","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the program (","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":") being called","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The response will be an array of Json Objects, each of which will contain the three input parameters as well as two of three possible extra fields -- \"runCount\", which is count for the program run, \"statusCode\", which maps to the status code for retrieving the run count for that program, and \"error\" if there was an error retrieving runs for that program. The \"statusCode\" property will always be included, but \"runCount\" and \"error\" are mutually exclusive.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e33db64e-fe96-4ee7-8fbe-f5b659ea5a55"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"runCount","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"The number of program runs for the program defined by the individual JSON object's parameters over the entire lifetime","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"statusCode","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"The status code from retrieving the program run count","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[243.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[517.0]},"content":[{"type":"paragraph","content":[{"text":"If an error, a description of why the status was not retrieved (for example, the specified program was not found, or the requested JSON object was missing a parameter)","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a0516773-0bac-41b2-bf01-e23510187947"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"POST /v3/namespaces/default/runcount","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Body","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\"}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"[{\"appId\": \"App1\", \"programType\": \"Service\", \"programId\": \"Service1\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"runCount\": 20},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App1\", \"programType\": \"Workflow\", \"programId\": \"testWorkflow\", \"statusCode\": 404,","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"error\": \"Program 'testWorkflow' is not found\"},","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"{\"appId\": \"App2\", \"programType\": \"Workflow\", \"programId\": \"DataPipelineWorkflow\",","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"\"statusCode\": 200, \"runCount\": 300}]","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[247.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[513.0]},"content":[{"type":"paragraph","content":[{"text":"Attempt to retrieve the run count of the service ","type":"text"},{"text":"Service1","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":", the workflow ","type":"text"},{"text":"testWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App1","type":"text","marks":[{"type":"em"}]},{"text":" and the workflow ","type":"text"},{"text":"DataPipelineWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" in the application ","type":"text"},{"text":"App2","type":"text","marks":[{"type":"em"}]},{"text":", all in the namespace ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieving Specific Run Count","type":"text"}]},{"type":"paragraph","content":[{"text":"To fetch the run count for a particular program, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"GET /v3/namespaces//apps/{app-id}/{program-type}/{program-id}/runcount","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c18d8c2d-846b-4f7d-8ac4-e21703ace5f0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"program-type","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"One of ","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"code"}]},{"text":", or ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"program-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the program (","type":"text"},{"text":"mapreduce","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"workflow","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"service","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"worker","type":"text","marks":[{"type":"em"}]},{"text":") being called","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4de8a4a8-c8c3-4979-9f86-a828a4c0c56d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"GET /v3/namespaces/default/apps/myApp/workflows/DataPipelineWorkflow/runcount","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"[2]","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"76f7e60e-07ad-4bd2-b1c2-a9276ca352dd"}},{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[245.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[515.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieve the run count of the workflow ","type":"text"},{"text":"DataPipelineWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"myApp","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflow Runs: Suspend and Resume","type":"text"}]},{"type":"paragraph","content":[{"text":"For workflows, in addition to starting and stopping, you can suspend and resume individual runs of a workflow using the RESTful API.","type":"text"}]},{"type":"paragraph","content":[{"text":"Suspend:","type":"text","marks":[{"type":"strong"}]},{"text":" To ","type":"text"},{"text":"suspend","type":"text","marks":[{"type":"em"}]},{"text":" means that the current activity will be taken to completion, but no further programs will be initiated. Programs will not be left partially uncompleted, barring any errors.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the case of a workflow with multiple MapReduce programs, if one of them is running (first of three perhaps) and you suspend the workflow, that first MapReduce will be completed but the following two will not be started.","type":"text"}]},{"type":"paragraph","content":[{"text":"Resume:","type":"text","marks":[{"type":"strong"}]},{"text":" To ","type":"text"},{"text":"resume","type":"text","marks":[{"type":"em"}]},{"text":" means that activity will start up where it was left off, beginning with the start of the next program in the sequence.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the case of the workflow mentioned above, resuming it after suspension would start up with the second of the three MapReduce programs, which is where it would have left off when it was suspended.","type":"text"}]},{"type":"paragraph","content":[{"text":"With workflows, ","type":"text"},{"text":"suspend","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"resume","type":"text","marks":[{"type":"em"}]},{"text":" require a ","type":"text"},{"text":"run-id","type":"text","marks":[{"type":"em"}]},{"text":" as the action takes place on either a currently running or suspended workflow.","type":"text"}]},{"type":"paragraph","content":[{"text":"To suspend or resume a workflow, use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /v3/namespaces//apps//workflows//runs//suspend\nPOST /v3/namespaces//apps//workflows//runs//resume","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2281c140-275f-47d2-be1d-d3fef2c1924a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"namespace-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Namespace ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"app-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"workflow-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the workflow","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[220.0]},"content":[{"type":"paragraph","content":[{"text":"run-id","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[540.0]},"content":[{"type":"paragraph","content":[{"text":"UUID of the workflow run","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: Suspending a Workflow","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"75daa802-000f-463c-a38f-ee65f4f2a6bf"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[262.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Method","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[498.0]},"content":[{"type":"paragraph","content":[{"text":"POST /v3/namespaces/default/apps/PurchaseHistory/workflows/PurchaseHistoryWorkflow/runs/0ce13912-e980-11e4-a7d7-8cae4cfd0e64/suspend","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[262.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Response","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[498.0]},"content":[{"type":"paragraph","content":[{"text":"Program run suspended.","type":"text","marks":[{"type":"code"}]},{"text":" if successfully set as suspended","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[262.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[498.0]},"content":[{"type":"paragraph","content":[{"text":"Suspends the run ","type":"text"},{"text":"0ce13912-e980-11e4-a7d7-8cae4cfd0e64","type":"text","marks":[{"type":"code"}]},{"text":" of the workflow ","type":"text"},{"text":"PurchaseHistoryWorkflow","type":"text","marks":[{"type":"em"}]},{"text":" of the application ","type":"text"},{"text":"PurchaseHistory","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported