You're viewing version 2.13 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Update a connector
Introduced 2.12
Use this API to update a standalone connector based on the model_ID
. To update a connector created within a specific model, use the Update Model API.
Before updating a standalone connector, you must undeploy all models that use the connector. For information about undeploying a model, see Undeploy Model API.
Using this API, you can update the connector fields listed in the Request fields section and add optional fields to your connector. You cannot delete fields from a connector using this API.
For information about user access for this API, see Model access control considerations.
Path and HTTP methods
PUT /_plugins/_ml/connectors/<connector_id>
Request fields
The following table lists the updatable fields. For more information about all connector fields, see Blueprint configuration parameters.
Field | Data type | Description |
---|---|---|
name | String | The name of the connector. |
description | String | A description of the connector. |
version | Integer | The version of the connector. |
protocol | String | The protocol for the connection. For AWS services, such as Amazon SageMaker and Amazon Bedrock, use aws_sigv4 . For all other services, use http . |
parameters | JSON object | The default connector parameters, including endpoint and model . Any parameters included in this field can be overridden by parameters specified in a predict request. |
credential | JSON object | Defines any credential variables required in order to connect to your chosen endpoint. ML Commons uses AES/GCM/NoPadding symmetric encryption to encrypt your credentials. When the connection to the cluster first starts, OpenSearch creates a random 32-byte encryption key that persists in OpenSearch’s system index. Therefore, you do not need to manually set the encryption key. |
actions | JSON array | Defines which actions can run within the connector. If you’re an administrator creating a connection, add the blueprint for your desired connection. |
backend_roles | JSON array | A list of OpenSearch backend roles. For more information about setting up backend roles, see Assigning backend roles to users. |
access_mode | String | Sets the access mode for the model, either public , restricted , or private . Default is private . For more information about access_mode , see Model groups. |
Example request
PUT /_plugins/_ml/connectors/u3DEbI0BfUsSoeNTti-1
{
"description": "The connector to public OpenAI model service for GPT 3.5"
}
Example response
{
"_index": ".plugins-ml-connector",
"_id": "u3DEbI0BfUsSoeNTti-1",
"_version": 2,
"result": "updated",
"_shards": {
"total": 1,
"successful": 1,
"failed": 0
},
"_seq_no": 2,
"_primary_term": 1
}