Retrieves the details of a specified data catalog bound to a Luma Agent. You can only query data catalogs that are already bound to the Agent. A ResourceNotFound error is returned for unbound catalogs.
Operation description
Retrieves the details of a specified data catalog bound to a Luma Agent. You can only query data catalogs that are already bound to the Agent. A ResourceNotFound error is returned for unbound catalogs.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AgentName |
string |
Yes |
The name of the Agent. |
my_agent |
| Name |
string |
Yes |
The name of the data catalog bound to the Agent. You can call ListLumaCatalogs to obtain the name. |
my_catalog |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| Message |
string |
The message returned by the operation. The value is Operation success when the call succeeds, or a specific error description when the call fails. |
Operation success |
| RequestId |
string |
The unique identifier of the request, used for troubleshooting and ticket submission. |
34AD682D-5B91-5773-8132-AA38C130**** |
| Data | Catalog |
The details of the data catalog bound to the Agent. |
|
| Code |
string |
The response code. A value of Success indicates a successful call. A specific error code is returned if the call fails. |
Success |
| Success |
boolean |
Indicates whether the call was successful. A value of true indicates success. |
true |
Examples
Success response
JSON format
{
"Message": "Operation success",
"RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
"Data": {
"Name": "my_catalog",
"Type": "RELATIONAL",
"Provider": "EventHouse",
"Comment": "Test data catalog",
"Properties": {
"IndexPattern": "my-index-*"
},
"ConnectionName": "my_connection"
},
"Code": "Success",
"Success": true
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid | |
| 403 | ServiceNotEnable | Service not enable | |
| 404 | AgentNotFound | Agent not found | |
| 404 | ResourceNotFound | The specified resource is not bound to the agent |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.