Update connector API key ID APIedit
This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
Updates the api_key_id
and/or api_key_secret_id
field(s) of a connector, specifying:
- The ID of the API key used for authorization
- The ID of the Connector Secret where the API key is stored
The Connector Secret ID is only required for native connectors. Connector clients do not use this field. See the documentation for managing native connector API keys programmatically for more details.
Requestedit
PUT _connector/<connector_id>/_api_key_id
Prerequisitesedit
- To sync data using connectors, it’s essential to have the Elastic connectors service running.
-
The
connector_id
parameter should reference an existing connector. -
The
api_key_id
parameter should reference an existing API key. -
The
api_key_secret_id
parameter should reference an existing Connector Secret containing an encoded API key value.
Path parametersedit
-
<connector_id>
- (Required, string)
Request bodyedit
-
api_key_id
- (Optional, string) ID of the API key that the connector will use to authorize access to required indices. Each connector can be associated with at most one API key.
-
api_key_secret_id
-
(Optional, string) ID of the Connector Secret that contains the encoded API key. This should be the same API key as
api_key_id
references. This is only required for native connectors.
Response codesedit
-
200
-
Connector
api_key_id
and/orapi_key_secret_id
field(s) successfully updated. -
400
-
The
connector_id
was not provided or the request payload was malformed. -
404
(Missing resources) -
No connector matching
connector_id
could be found.
Examplesedit
The following example updates the api_key_id
and api_key_secret_id
field(s) for the connector with ID my-connector
:
PUT _connector/my-connector/_api_key_id { "api_key_id": "my-api-key-id", "api_key_secret_id": "my-connector-secret-id" }
{ "result": "updated" }