Data Source

A DataSource is a plugin instance collecting `metric` and `log` data from Cloudforet.

Package : spaceone.api.monitoring.v1

DataSource

DataSource Methods:

Method	Request	Response
register	RegisterDataSourceRequest	DataSourceInfo
update	UpdateDataSourceRequest	DataSourceInfo
enable	DataSourceRequest	DataSourceInfo
disable	DataSourceRequest	DataSourceInfo
deregister	DataSourceRequest	google.protobuf.Empty
update_plugin	UpdateDataSourcePluginRequest	DataSourceInfo
verify_plugin	DataSourceRequest	google.protobuf.Empty
get	GetDataSourceRequest	DataSourceInfo
list	DataSourceQuery	DataSourcesInfo
stat	DataSourceStatQuery	google.protobuf.Struct

register

POST /monitoring/v1/data-sources

Registers a DataSource with information of the plugin to use. Information of the plugin includes version, provider, upgrade_mode.

Type	Message
Request	RegisterDataSourceRequest
Response	DataSourceInfo

Request Example

{
    "name": "datasource-test",
    "plugin_info": {
        "plugin_id": "plugin-123456789012",
        "version": "1.1.4.20220617.135934",
        "options": {},
        "provider": "aws",
        "metadata": {
            "supported_resource_type": [
                "inventory.Server",
                "inventory.CloudService"
            ],
            "required_keys": [
                "data.cloudwatch"
            ],
            "supported_stat": [
                "AVERAGE",
                "MAX",
                "MIN",
                "SUM"
            ]
        },
        "upgrade_mode": "AUTO"
    },
    "tags": {
        "a": "b"
    },
    "domain_id": "domain-123456789012"
}

Response Example

update

PUT /monitoring/v1/data-source/{data_source_id}

Updates a specific DataSource. You can make changes in DataSource settings, including name and tags.

Type	Message
Request	UpdateDataSourceRequest
Response	DataSourceInfo

Request Example

{
    "data_source_id": "ds-123456789012",
    "name": "tmp-datasource_test",
    "tags": {
        "b": "c"
    },
    "domain_id": "domain-123456789012"
}

Response Example

enable

PUT /monitoring/v1/data-source/{data_source_id}/enable

Enables a specific DataSource. By enabling a DataSource, you can communicate with an external cloud service via the plugin.

Type	Message
Request	DataSourceRequest
Response	DataSourceInfo

Request Example

{
    "data_source_id": "ds-6167ed6b42f4",
    "domain_id": "domain-123456789012"
}

Response Example

disable

PUT /monitoring/v1/data-source/{data_source_id}/disable

Disables a specific DataSource. By disabling a DataSource, you can block communication with an external cloud service via the plugin.

Type	Message
Request	DataSourceRequest
Response	DataSourceInfo

Request Example

{
    "data_source_id": "ds-6167ed6b42f4",
    "domain_id": "domain-123456789012"
}

Response Example

deregister

DELETE /monitoring/v1/data-source/{data_source_id}

Deregisters and deletes a specific DataSource. You must specify the data_source_id of the DataSource to deregister.

Type	Message
Request	DataSourceRequest
Response	google.protobuf.Empty

Request Example

{
    "data_source_id": "ds-6167ed6b42f4",
    "domain_id": "domain-123456789012"
}

update_plugin

PUT /monitoring/v1/data-source/{data_source_id}/plugin

Updates the plugin of a specific DataSource. This method resets the plugin data in the DataSource to update the metadata.

Type	Message
Request	UpdateDataSourcePluginRequest
Response	DataSourceInfo

Request Example

{
    "data_source_id": "ds-6167ed6b42f4",
    "version": "1.1.3",
    "options": {},
    "upgrade_mode": "MANUAL",
    "domain_id": "domain-123456789012"
}

Response Example

verify_plugin

PUT /monitoring/v1/data-source/{data_source_id}/plugin/verify

Verifies the plugin of a specific DataSource. This method validates the plugin data, version and endpoint.

Type	Message
Request	DataSourceRequest
Response	google.protobuf.Empty

Request Example

{
    "data_source_id": "ds-6167ed6b42f4",
    "domain_id": "domain-123456789012"
}

get

GET /monitoring/v1/data-source/{data_source_id}

Gets a specific DataSource. Prints detailed information about the DataSource, including name, state, and plugin_info.

Type	Message
Request	GetDataSourceRequest
Response	DataSourceInfo

Request Example

{
    "data_source_id": "ds-123456789012",
    "domain_id": "domain-123456789012"
}

Response Example

list

GET /monitoring/v1/data-sources

POST /monitoring/v1/data-sources/search

Gets a list of all DataSources. You can use a query to get a filtered list of DataSources.

Type	Message
Request	DataSourceQuery
Response	DataSourcesInfo

Request Example

{
    "query": {},
    "domain_id": "domain-123456789012"
}

Response Example

stat

POST /monitoring/v1/data-sources/stat

Type	Message
Request	DataSourceStatQuery
Response	google.protobuf.Struct

Message

DataSourceInfo

Field	Type	Description
data_source_id	string
name	string
state	NONE ENABLED DISABLED
monitoring_type	NONE METRIC LOG
provider	string
capability	google.protobuf.Struct
plugin_info	DataSourcePluginInfo
tags	google.protobuf.Struct
domain_id	string
created_at	string

DataSourcePluginInfo

Field	Type	Description
plugin_id	string
version	string
options	google.protobuf.Struct
metadata	google.protobuf.Struct
upgrade_mode	NONE MANUAL AUTO
secret_id	string
provider	string

DataSourceQuery

Field	Type	Required	Description
query	spaceone.api.core.v1.Query	✘
data_source_id	string	✘
name	string	✘
state	string	✘
monitoring_type	NONE METRIC LOG	✘
provider	string	✘
domain_id	string	✔

DataSourceRequest

Field	Type	Required	Description
data_source_id	string	✔
domain_id	string	✔

DataSourceStatQuery

Field	Type	Required	Description
query	spaceone.api.core.v1.StatisticsQuery	✔
domain_id	string	✔

DataSourcesInfo

Field	Type	Description
results	list of DataSourceInfo
total_count	int32

GetDataSourceRequest

Field	Type	Required	Description
data_source_id	string	✔
domain_id	string	✔
only	list of string	✘

RegisterDataSourceRequest

Field	Type	Required	Description
name	string	✔
plugin_info	DataSourcePluginInfo	✔
tags	google.protobuf.Struct	✘
domain_id	string	✔

UpdateDataSourcePluginRequest

Field	Type	Required	Description
data_source_id	string	✔
version	string	✘
options	google.protobuf.Struct	✘
upgrade_mode	NONE MANUAL AUTO	✘
domain_id	string	✔

UpdateDataSourceRequest

Field	Type	Required	Description
data_source_id	string	✔
name	string	✘
tags	google.protobuf.Struct	✘
domain_id	string	✔