Invoking a Model Deployment
Invoking a model deployment means that you can pass feature vectors or data samples to the predict endpoint, and then the model returns predictions for those data samples.
After a model deployment is in an active lifecycleState
, the predict endpoint can successfully receive requests made by clients.
From a model deployment detail page, click Invoking Your Model. The following details are displayed:
- The model HTTP endpoint.
- Sample code to invoke the model endpoint using the OCI CLI. Or, use the OCI Python and Java SDKs to invoke the model with the provide code sample.
-
The payload size limit is 10 MB.
-
The timeout on invoking a model is 60 seconds for HTTP calls.
Use the sample code to invoke a model deployment.
Invoking a model deployment calls the predict endpoint of the model deployment URI. This endpoint takes sample data as input and is processed using the predict()
function in the score.py
model artifact file. The sample data is in JSON format though can be in other formats. Processing means that the sample data could be transformed then passed to a models inference method. The models can generate predictions that can be processed before being returned back to the client.
The API responses are:
HTTP Status Code | Error Code | Description | Retry |
---|---|---|---|
200 |
None |
200 Success.
|
None |
404 |
NotAuthorizedOrNotFound |
Model deployment not found or authorization failed. |
No |
405 |
MethodNotAllowed |
Method not allowed. |
No |
411 |
LengthRequired |
Missing content length header. |
No |
413 |
PayloadTooLarge |
The payload size limit is 10 MB. |
No |
429 |
TooManyRequests |
Too Many Requests.
|
Yes, with backoff |
500 |
InternalServerError |
Internal Server Error.
|
Yes, with backoff |
503 |
ServiceUnavailable |
Model server unavailable. |
Yes, with backoff |
Model Inference Endpoint (Predict) Request Throttling
Predict endpoint requests might be throttled based on activity and resource consumption over time.
This is to maintain high availability and fair use of resources by protecting model serving application servers from being overwhelmed by too many requests, and prevent denial-of-service attacks. If you make too many requests too quickly, you might see some succeed while others fail. When a request fails because of throttling, the service returns response code 429 with one of the following error codes and description:
{ "code": "TooManyRequests", "message": "Tenancy request-rate limit exceeded.
Please use the OCI Console to submit a support ticket for your tenancy to increase the RPS."}
Or
{ "code": "TooManyRequests", "message": "LB bandwidth limit exceeded.
Consider increasing the provisioned load balancer bandwidth to avoid these errors." }
Invoking with the OCI Python SDK
This example code is a reference to help you invoke your model deployment:
import requests
import oci
from oci.signer import Signer
import json
# model deployment endpoint. Here we assume that the notebook region is the same as the region where the model deployment occurs.
# Alternatively you can also go in the details page of your model deployment in the OCI console. Under "Invoke Your Model", you will find the HTTP endpoint
# of your model.
endpoint = <your-model-deployment-uri>
# your payload:
input_data = <your-json-payload-str>
if using_rps: # using resource principal:
auth = oci.auth.signers.get_resource_principals_signer()
else: # using config + key:
config = oci.config.from_file("~/.oci/config") # replace with the location of your oci config file
auth = Signer(
tenancy=config['tenancy'],
user=config['user'],
fingerprint=config['fingerprint'],
private_key_file_location=config['key_file'],
pass_phrase=config['pass_phrase'])
# post request to model endpoint:
response = requests.post(endpoint, json=input_data, auth=auth)
# Check the response status. Success should be an HTTP 200 status code
assert response.status_code == 200, "Request made to the model predict endpoint was unsuccessful"
# print the model predictions. Assuming the model returns a JSON object.
print(json.loads(response.content))
Invoking with the OCI CLI
Use a model deployment in the CLI by invoking it.
The CLI is included in the OCI Cloud Shell environment, and is preauthenticated. This example invokes a model deployment with the CLI:
oci raw-request --http-method POST --target-uri
<model-deployment-url>/predict --request-body '{"data": "data"}'