Runs the specified StorageConnection.
When a run is successfully created, the operation returns HTTP status code 202/accepted - the request is accepted for processing and will execute in background. The response will include a location header pointing to the created run. If an existing active run already exists for the iModel, a new run is not initiated, instead 303/see other is returned along with location header pointing to that existing active run. In the rare event that multiple create run requests are being made simultaneously, only the first request is processed and 409/conflict is returned for others.
Authorization header with valid Bearer token for scope
For more documentation on authorization and how to get access token visit OAUTH2 Authorization page.
OAuth access token with scope
application/vnd.bentley.itwin-platform.v1+json is recommended.
Response 202 Accepted
Response 303 See Other
This response indicates that an active run is in progress and link is provided in location header.
Response 401 Unauthorized
This response indicates that request lacks valid authentication credentials. Access token might not been provided, issued by the wrong issuer, does not have required scopes or request headers were malformed.
Response 403 Forbidden
This response indicates that user does not have required permissions to run specified connection.
Response 404 Not Found
This response indicates that the specified connection was not found.
Response 409 Conflict
A run request is already being processed.
Response 422 Unprocessable Entity
Invalid request to get run connection.
Response 429 Too many requests
This response indicates that the user has sent too many requests in a given amount of time.
The number of requests exceeds the rate-limit for the client subscription.