propertymapper#
Autogenerated API
- argus_api.lib.configurationadmin.v1.propertymapper.create_property_mapper(name: str = None, shortName: str = None, configuration: str = None, description: str = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Create new property mapper (INTERNAL)
- Parameters
name (str) – Name of the property mapper configuration => [a-zA-Z0-9_:\-.]*
shortName (str) – Unique short name of the property mapper configuration => [a-zA-Z0-9_:\-.]*
configuration (str) – The JSON configuration
description (str) – The property mapper description (default null) => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.delete_property_mapper(idOrShortName: str, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Delete a property mapper by its id or shortname. This creates a revision with the same contents as the primary version at the time the request is made.The new primary is, however, flagged as deleted. NB: You can only delete the current primary and only if it is not already deleted. (INTERNAL)
- Parameters
idOrShortName (str) – ID or shortname of a property mapper
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.get_property_mapper(idOrShortName: str, includeConfig: bool = True, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Get a property mapper by its id or shortname.Fetching by short name will always return the master revision.Fetching by ID will return the specifically requested property mapper revision. (INTERNAL)
- Parameters
idOrShortName (str) – ID or shortName of a property mapper
includeConfig (bool) – Whether to include the property mapper config too
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.get_property_mapper_revision(idOrShortName: str, revision: int, includeConfig: bool = True, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Get a property mapper by its id or shortname and revision number (INTERNAL)
- Parameters
idOrShortName (str) – ID or shortName of a property mapper
revision (int) – Property mapper revision number
includeConfig (bool) – Whether to include the property mapper config too
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.list_property_mapper_revisions(idOrShortName: str, limit: int = 25, offset: int = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
List a property mapper’s - retrieved by its id or shortname - revisions. (INTERNAL)
- Parameters
idOrShortName (str) – ID or shortname of a property mapper
limit (int) – Limit results
offset (int) – Offset results
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.list_property_mappers(keyword: str = None, keywordField: str = None, timestampField: str = None, sortBy: str = None, limit: int = 25, includeConfig: bool = True, keywordMatch: str = 'all', timestampMatch: str = 'all', offset: int = None, includeDeleted: bool = None, start: int = None, end: int = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
List primary property mappers matching the provided criteria (INTERNAL)
- Parameters
keyword (list) – Search by keywords
keywordField (list) – Set field strategy for keyword search
timestampField (list) – Set field strategy for timestamp filtering
sortBy (list) – Field(s) to sort by - refer to the search POST endpoint to see which fields are permitted
limit (int) – Maximum number of hits to return
includeConfig (bool) – Whether to include the property mapper config too
keywordMatch (str) – Set match strategy for keyword search
timestampMatch (str) – Set match strategy for timestamp filtering
offset (int) – Number of hits to skip in the result set - useful for pagination
includeDeleted (bool) – Include deleted
start (int) – Lower bound timestamp filter value
end (int) – Upper bound timestamp filter value
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.restore_property_mapper(idOrShortName: str, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Restore a property mapper by its id or shortname. This creates a revision with the same contents as the primary version at the time the request is made.The new primary is, however, no longer flagged as deleted. NB: You can only restore the current primary and only if it is already deleted. (INTERNAL)
- Parameters
idOrShortName (str) – ID or shortname of a property mapper
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.rollback_property_mapper(idOrShortName: str, revision: int, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Rollback a property mapper to the requested revision. Similar to updating a property mapper, this creates a revision based on the contents of the primary version at the time the request is made. The new primary property mapper will contain the same values as the rollback target version.NB: You cannot rollback to a deleted version or to the current primary. (INTERNAL)
- Parameters
idOrShortName (str) – ID or shortname of a property mapper
revision (int) – Revision to rollback to
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.search_property_mappers(sortBy: str = None, keywords: str = None, keywordFieldStrategy: str = None, keywordMatchStrategy: str = None, timeFieldStrategy: str = None, timeMatchStrategy: str = None, subCriteria: dict = None, idOrShortName: str = None, startTimestamp: int = None, endTimestamp: int = None, includeDeleted: bool = None, includeConfig: bool = None, limit: int = 25, offset: int = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Search for primary property mappers (INTERNAL)
- Parameters
sortBy (list) –
keywords (list) – Search for keywords against fields defined by keywordFieldStrategy
keywordFieldStrategy (list) – Defines which fields will be searched by keywords (default all supported fields) (default all)
keywordMatchStrategy (str) – Defines how strict different keywords should be matched (default match all keywords) (default all)
timeFieldStrategy (list) – Defines which timestamps fields will be filtered with start/endTimestamp (default lastUpdatedTimestamp)
timeMatchStrategy (str) – Defines how strict to match against different timestamps (all/any) using start and end timestamp (default any) (default any)
subCriteria (list) – Set additional criteria which are applied with logical OR by default
idOrShortName (list) – Filter by specific property mapper IDs or shortName.
startTimestamp (int) – Restrict to a time frame based on the set timeFieldStrategy (start timestamp) (default 0)
endTimestamp (int) – Restrict to a time frame based on the set timeFieldStrategy (end timestamp) (default 0)
includeDeleted (bool) – Whether to include deleted property mappers (default false)
includeConfig (bool) – Whether to include the property mapper JSON config in the result set (default false)
limit (int) – Limit maximum amount of results (default 25)
offset (int) – Skip specified amount of results (default 0)
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON
- argus_api.lib.configurationadmin.v1.propertymapper.update_property_mapper(idOrShortName: str, name: str = None, configuration: str = None, description: str = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) dict #
Update a property mapper. This creates a revision based on the contents of the primary version at the time the request is made.The new primary property mapper’s contents reflects the update request. (INTERNAL)
- Parameters
idOrShortName (str) – ID or shortname of a property mapper
name (str) – Name of the property mapper configuration => [a-zA-Z0-9_:\-.]*
configuration (str) – The JSON configuration
description (str) – The property mapper description => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*
json – return the response’s body as a
dict
parsed from json.True
by default. If set to false, the rawrequests.Response
object will be returned.verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.
apiKey – Argus API key.
authentication – authentication override
server_url – API base URL override
body – body of the request. other parameters will override keys defined in the body.
api_session – session to use for this request. If not set, the global session will be used.
- Raises
AuthenticationFailedException – on 401
AccessDeniedException – on 403
ObjectNotFoundException – on 404
ValidationErrorException – on 412
ArgusException – on other status codes
- Returns
dictionary translated from JSON