architecture-center icon indicating copy to clipboard operation
architecture-center copied to clipboard

Solution section is internally inconsistent and mismatches the major use-case

Open endintiers opened this issue 2 years ago • 1 comments

In the "Solution" section of this page the Diagram/Image indicates:

  1. Request => 202 Accepted (with location header set to status URL)
  2. Status Query (in progress) => 200 OK <== this is what is most obviously wrong
  3. Status Query (completed) => 302 Found (with redirect to completed resource)

Meanwhile the Text underneath indicates:

  1. Request => 202 Accepted (with location header set to status URL)
  2. Status Query (in progress) => 202 Accepted
  3. Status Query (completed) => 302 Found (with redirect to completed resource)

The Logic Apps HTTP shape (with default 'Asynchronous Pattern' = true setting) expects:

  1. Request => 202 Accepted (with location header set to status URL)
  2. Status Query (in progress) => 202 Accepted (with location header set to status URL)
  3. Status Query (completed) => 200 OK (no redirect) (Errors if given a 302)

Further down the example code implements:

  1. Request => 202 Accepted (with location header set to status URL)
  2. Status Query (in progress) => 202 Accepted (with location header set to status URL)
  3. Status Query (completed) => 200 OK (no redirect) OR 302 Found (with redirect to completed resource) - depending.

So what exactly IS the official pattern?


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

endintiers avatar Apr 17 '22 03:04 endintiers

Hi @endintiers , thanks for bringing this to our attention. I have assigned the issue to the content author to evaluate and update as appropriate

Grace-MacJones-MSFT avatar Apr 17 '22 07:04 Grace-MacJones-MSFT

#please-close

v-fearam avatar Nov 14 '22 18:11 v-fearam