Skip to content

Commit 05f4753

Browse files
Update azure/Guidelines.md
1 parent 80b9e02 commit 05f4753

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

azure/Guidelines.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -783,7 +783,9 @@ While Azure Managed Storage may be easier to get started with, as your service e
783783

784784
:ballot_box_with_check: **YOU SHOULD** if using HTTP (not HTTPS) document to users that all information is sent over the wire in clear text.
785785

786-
:white_check_mark: **DO** return an HTTP status code representing the result of your service operation's behavior. If the operation uses Storage internally, this an implementation detail from the client's perspective of the operation but may happen due to a missing Storage object or insufficient permissions. If the internal Storage operation fails, include the Storage error information in the 'inner-error' section of your operation's response body to help the client know that they may have configured their Storage improperly.
786+
:white_check_mark: **DO** return an HTTP status code representing the result of your service operation's behavior.
787+
788+
:white_check_mark: **DO** include the Storage error information in the 'inner-error' section of an error response if the error was the result of an internal Storage operation failure. This helps the client determine the underlying cause of the error, e.g.: a missing storage object or insufficient permissions.
787789

788790
:white_check_mark: **DO** allow the customer to specify a URL path to a single Storage object if your service requires access to a single file.
789791

0 commit comments

Comments
 (0)