f5d6cc8e5236d84e741319f00ef15d42d6d4a955
[platform/core/dotnet/build-tools.git] /
1 <?xml version="1.0"?>\r
2 <doc>\r
3     <assembly>\r
4         <name>Microsoft.AspNetCore.Diagnostics.HealthChecks</name>\r
5     </assembly>\r
6     <members>\r
7         <member name="T:Microsoft.AspNetCore.Builder.HealthCheckApplicationBuilderExtensions">\r
8             <summary>\r
9             <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/> extension methods for the <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckMiddleware"/>.\r
10             </summary>\r
11         </member>\r
12         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckApplicationBuilderExtensions.UseHealthChecks(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Http.PathString)">\r
13             <summary>\r
14             Adds a middleware that provides health check status.\r
15             </summary>\r
16             <param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>\r
17             <param name="path">The path on which to provide health check status.</param>\r
18             <returns>A reference to the <paramref name="app"/> after the operation has completed.</returns>\r
19             <remarks>\r
20             <para>\r
21             If <paramref name="path"/> is set to <c>null</c> or the empty string then the health check middleware\r
22             will ignore the URL path and process all requests. If <paramref name="path"/> is set to a non-empty\r
23             value, the health check middleware will process requests with a URL that matches the provided value\r
24             of <paramref name="path"/> case-insensitively, allowing for an extra trailing slash ('/') character.\r
25             </para>\r
26             <para>\r
27             The health check middleware will use default settings from <see cref="T:Microsoft.Extensions.Options.IOptions`1"/>.\r
28             </para>\r
29             </remarks>\r
30         </member>\r
31         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckApplicationBuilderExtensions.UseHealthChecks(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Http.PathString,Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions)">\r
32             <summary>\r
33             Adds a middleware that provides health check status.\r
34             </summary>\r
35             <param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>\r
36             <param name="path">The path on which to provide health check status.</param>\r
37             <param name="options">A <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions"/> used to configure the middleware.</param>\r
38             <returns>A reference to the <paramref name="app"/> after the operation has completed.</returns>\r
39             <remarks>\r
40             <para>\r
41             If <paramref name="path"/> is set to <c>null</c> or the empty string then the health check middleware\r
42             will ignore the URL path and process all requests. If <paramref name="path"/> is set to a non-empty\r
43             value, the health check middleware will process requests with a URL that matches the provided value\r
44             of <paramref name="path"/> case-insensitively, allowing for an extra trailing slash ('/') character.\r
45             </para>\r
46             </remarks>\r
47         </member>\r
48         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckApplicationBuilderExtensions.UseHealthChecks(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Http.PathString,System.Int32)">\r
49             <summary>\r
50             Adds a middleware that provides health check status.\r
51             </summary>\r
52             <param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>\r
53             <param name="path">The path on which to provide health check status.</param>\r
54             <param name="port">The port to listen on. Must be a local port on which the server is listening.</param>\r
55             <returns>A reference to the <paramref name="app"/> after the operation has completed.</returns>\r
56             <remarks>\r
57             <para>\r
58             If <paramref name="path"/> is set to <c>null</c> or the empty string then the health check middleware\r
59             will ignore the URL path and process all requests on the specified port. If <paramref name="path"/> is\r
60             set to a non-empty value, the health check middleware will process requests with a URL that matches the\r
61             provided value of <paramref name="path"/> case-insensitively, allowing for an extra trailing slash ('/')\r
62             character.\r
63             </para>\r
64             <para>\r
65             The health check middleware will use default settings from <see cref="T:Microsoft.Extensions.Options.IOptions`1"/>.\r
66             </para>\r
67             </remarks>\r
68         </member>\r
69         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckApplicationBuilderExtensions.UseHealthChecks(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Http.PathString,System.String)">\r
70             <summary>\r
71             Adds a middleware that provides health check status.\r
72             </summary>\r
73             <param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>\r
74             <param name="path">The path on which to provide health check status.</param>\r
75             <param name="port">The port to listen on. Must be a local port on which the server is listening.</param>\r
76             <returns>A reference to the <paramref name="app"/> after the operation has completed.</returns>\r
77             <remarks>\r
78             <para>\r
79             If <paramref name="path"/> is set to <c>null</c> or the empty string then the health check middleware\r
80             will ignore the URL path and process all requests on the specified port. If <paramref name="path"/> is\r
81             set to a non-empty value, the health check middleware will process requests with a URL that matches the\r
82             provided value of <paramref name="path"/> case-insensitively, allowing for an extra trailing slash ('/')\r
83             character.\r
84             </para>\r
85             <para>\r
86             The health check middleware will use default settings from <see cref="T:Microsoft.Extensions.Options.IOptions`1"/>.\r
87             </para>\r
88             </remarks>\r
89         </member>\r
90         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckApplicationBuilderExtensions.UseHealthChecks(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Http.PathString,System.Int32,Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions)">\r
91             <summary>\r
92             Adds a middleware that provides health check status.\r
93             </summary>\r
94             <param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>\r
95             <param name="path">The path on which to provide health check status.</param>\r
96             <param name="port">The port to listen on. Must be a local port on which the server is listening.</param>\r
97             <param name="options">A <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions"/> used to configure the middleware.</param>\r
98             <returns>A reference to the <paramref name="app"/> after the operation has completed.</returns>\r
99             <remarks>\r
100             <para>\r
101             If <paramref name="path"/> is set to <c>null</c> or the empty string then the health check middleware\r
102             will ignore the URL path and process all requests on the specified port. If <paramref name="path"/> is\r
103             set to a non-empty value, the health check middleware will process requests with a URL that matches the\r
104             provided value of <paramref name="path"/> case-insensitively, allowing for an extra trailing slash ('/')\r
105             character.\r
106             </para>\r
107             </remarks>\r
108         </member>\r
109         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckApplicationBuilderExtensions.UseHealthChecks(Microsoft.AspNetCore.Builder.IApplicationBuilder,Microsoft.AspNetCore.Http.PathString,System.String,Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions)">\r
110             <summary>\r
111             Adds a middleware that provides health check status.\r
112             </summary>\r
113             <param name="app">The <see cref="T:Microsoft.AspNetCore.Builder.IApplicationBuilder"/>.</param>\r
114             <param name="path">The path on which to provide health check status.</param>\r
115             <param name="port">The port to listen on. Must be a local port on which the server is listening.</param>\r
116             <param name="options">A <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions"/> used to configure the middleware.</param>\r
117             <returns>A reference to the <paramref name="app"/> after the operation has completed.</returns>\r
118             <remarks>\r
119             <para>\r
120             If <paramref name="path"/> is set to <c>null</c> or the empty string then the health check middleware\r
121             will ignore the URL path and process all requests on the specified port. If <paramref name="path"/> is\r
122             set to a non-empty value, the health check middleware will process requests with a URL that matches the\r
123             provided value of <paramref name="path"/> case-insensitively, allowing for an extra trailing slash ('/')\r
124             character.\r
125             </para>\r
126             </remarks>\r
127         </member>\r
128         <member name="T:Microsoft.AspNetCore.Builder.HealthCheckEndpointRouteBuilderExtensions">\r
129             <summary>\r
130             Provides extension methods for <see cref="T:Microsoft.AspNetCore.Routing.IEndpointRouteBuilder"/> to add health checks.\r
131             </summary>\r
132         </member>\r
133         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckEndpointRouteBuilderExtensions.MapHealthChecks(Microsoft.AspNetCore.Routing.IEndpointRouteBuilder,System.String)">\r
134             <summary>\r
135             Adds a health checks endpoint to the <see cref="T:Microsoft.AspNetCore.Routing.IEndpointRouteBuilder"/> with the specified template.\r
136             </summary>\r
137             <param name="endpoints">The <see cref="T:Microsoft.AspNetCore.Routing.IEndpointRouteBuilder"/> to add the health checks endpoint to.</param>\r
138             <param name="pattern">The URL pattern of the health checks endpoint.</param>\r
139             <returns>A convention routes for the health checks endpoint.</returns>\r
140         </member>\r
141         <member name="M:Microsoft.AspNetCore.Builder.HealthCheckEndpointRouteBuilderExtensions.MapHealthChecks(Microsoft.AspNetCore.Routing.IEndpointRouteBuilder,System.String,Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions)">\r
142             <summary>\r
143             Adds a health checks endpoint to the <see cref="T:Microsoft.AspNetCore.Routing.IEndpointRouteBuilder"/> with the specified template and options.\r
144             </summary>\r
145             <param name="endpoints">The <see cref="T:Microsoft.AspNetCore.Routing.IEndpointRouteBuilder"/> to add the health checks endpoint to.</param>\r
146             <param name="pattern">The URL pattern of the health checks endpoint.</param>\r
147             <param name="options">A <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions"/> used to configure the health checks.</param>\r
148             <returns>A convention routes for the health checks endpoint.</returns>\r
149         </member>\r
150         <member name="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckMiddleware">\r
151             <summary>\r
152             Middleware that exposes a health checks response with a URL endpoint.\r
153             </summary>\r
154         </member>\r
155         <member name="M:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckMiddleware.#ctor(Microsoft.AspNetCore.Http.RequestDelegate,Microsoft.Extensions.Options.IOptions{Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions},Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckService)">\r
156             <summary>\r
157             Creates a new instance of <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckMiddleware"/>.\r
158             </summary>\r
159         </member>\r
160         <member name="M:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckMiddleware.InvokeAsync(Microsoft.AspNetCore.Http.HttpContext)">\r
161             <summary>\r
162             Processes a request.\r
163             </summary>\r
164             <param name="httpContext"></param>\r
165             <returns></returns>\r
166         </member>\r
167         <member name="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions">\r
168             <summary>\r
169             Contains options for the <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckMiddleware"/>.\r
170             </summary>\r
171         </member>\r
172         <member name="P:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions.Predicate">\r
173             <summary>\r
174             Gets or sets a predicate that is used to filter the set of health checks executed.\r
175             </summary>\r
176             <remarks>\r
177             If <see cref="P:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions.Predicate"/> is <c>null</c>, the <see cref="T:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckMiddleware"/> will run all\r
178             registered health checks - this is the default behavior. To run a subset of health checks,\r
179             provide a function that filters the set of checks.\r
180             </remarks>\r
181         </member>\r
182         <member name="P:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions.ResultStatusCodes">\r
183             <summary>\r
184             Gets or sets a dictionary mapping the <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> to an HTTP status code applied\r
185             to the response. This property can be used to configure the status codes returned for each status.\r
186             </summary>\r
187             <remarks>\r
188             Setting this property to <c>null</c> resets the mapping to its default value which maps\r
189             <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Healthy"/> to 200 (OK), <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Degraded"/> to 200 (OK) and\r
190             <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy"/> to 503 (Service Unavailable).\r
191             </remarks>\r
192             <exception cref="T:System.InvalidOperationException">Thrown if at least one <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> is missing when setting this property.</exception>\r
193         </member>\r
194         <member name="P:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions.ResponseWriter">\r
195             <summary>\r
196             Gets or sets a delegate used to write the response.\r
197             </summary>\r
198             <remarks>\r
199             The default value is a delegate that will write a minimal <c>text/plain</c> response with the value\r
200             of <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport.Status"/> as a string.\r
201             </remarks>\r
202         </member>\r
203         <member name="P:Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions.AllowCachingResponses">\r
204             <summary>\r
205             Gets or sets a value that controls whether responses from the health check middleware can be cached.\r
206             </summary>\r
207             <remarks>\r
208             <para>\r
209             The health check middleware does not perform caching of any kind. This setting configures whether\r
210             the middleware will apply headers to the HTTP response that instruct clients to avoid caching.\r
211             </para>\r
212             <para>\r
213             If the value is <c>false</c> the health check middleware will set or override the\r
214             <c>Cache-Control</c>, <c>Expires</c>, and <c>Pragma</c> headers to prevent response caching. If the value\r
215             is <c>true</c> the health check middleware will not modify the cache headers of the response.\r
216             </para>\r
217             </remarks>\r
218         </member>\r
219         <member name="P:Microsoft.AspNetCore.Diagnostics.HealthChecks.Resources.UnableToFindServices">\r
220             <summary>Unable to find the required services. Please add all the required services by calling '{0}.{1}' inside the call to '{2}' in the application startup code.</summary>\r
221         </member>\r
222         <member name="M:Microsoft.AspNetCore.Diagnostics.HealthChecks.Resources.FormatUnableToFindServices(System.Object,System.Object,System.Object)">\r
223             <summary>Unable to find the required services. Please add all the required services by calling '{0}.{1}' inside the call to '{2}' in the application startup code.</summary>\r
224         </member>\r
225     </members>\r
226 </doc>\r