sdk.lusid.api.placements_api.PlacementsApi

class PlacementsApi(api_client=None)[source]

NOTE: This class is auto generated by OpenAPI Generator Ref: https://openapi-generator.tech

Do not edit the class manually.

Methods

delete_placement

[EARLY ACCESS] DeletePlacement: Delete placement # noqa: E501

delete_placement_with_http_info

[EARLY ACCESS] DeletePlacement: Delete placement # noqa: E501

get_placement

[EARLY ACCESS] GetPlacement: Get Placement # noqa: E501

get_placement_with_http_info

[EARLY ACCESS] GetPlacement: Get Placement # noqa: E501

list_placements

[EARLY ACCESS] ListPlacements: List Placements # noqa: E501

list_placements_with_http_info

[EARLY ACCESS] ListPlacements: List Placements # noqa: E501

upsert_placements

[EARLY ACCESS] UpsertPlacements: Upsert Placement # noqa: E501

upsert_placements_with_http_info

[EARLY ACCESS] UpsertPlacements: Upsert Placement # noqa: E501

delete_placement(scope, code, async_req=None, **kwargs)[source]

[EARLY ACCESS] DeletePlacement: Delete placement # noqa: E501

Delete an placement. Deletion will be valid from the placement’s creation datetime. This means that the placement will no longer exist at any effective datetime from the asAt datetime of deletion. # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.delete_placement(scope, code, async_req=True)
>>> result = thread.get()
Parameters:
  • scope (str) – The placement scope. (required)

  • code (str) – The placement’s code. This, together with the scope uniquely identifies the placement to delete. (required)

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

DeletedEntityResponse

delete_placement_with_http_info(scope, code, **kwargs)[source]

[EARLY ACCESS] DeletePlacement: Delete placement # noqa: E501

Delete an placement. Deletion will be valid from the placement’s creation datetime. This means that the placement will no longer exist at any effective datetime from the asAt datetime of deletion. # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.delete_placement_with_http_info(scope, code, async_req=True)
>>> result = thread.get()
Parameters:
  • scope (str) – The placement scope. (required)

  • code (str) – The placement’s code. This, together with the scope uniquely identifies the placement to delete. (required)

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _preload_content (bool, optional) – if False, the ApiResponse.data will be set to none and raw_data will store the HTTP response body without reading/decoding. Default is True.

  • _return_http_data_only (bool, optional) – response data instead of ApiResponse object with status code, headers, etc

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

tuple(DeletedEntityResponse, status_code(int), headers(HTTPHeaderDict))

get_placement(scope, code, as_at=None, property_keys=None, async_req=None, **kwargs)[source]

[EARLY ACCESS] GetPlacement: Get Placement # noqa: E501

Fetch a Placement that matches the specified identifier # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.get_placement(scope, code, as_at, property_keys, async_req=True)
>>> result = thread.get()
Parameters:
  • scope (str) – The scope to which the placement belongs. (required)

  • code (str) – The placement’s unique identifier. (required)

  • as_at (datetime) – The asAt datetime at which to retrieve the placement. Defaults to return the latest version of the placement if not specified.

  • property_keys (List[str]) – A list of property keys from the “Placement” domain to decorate onto the placement. If none are given, all applied properties are returned. These take the format {domain}/{scope}/{code} e.g. “Placement/system/Name”. Property keys from the instrument domain can also be decorated onto the placement, e.g. “Instrument/default/Isin”. These are only decorated if requested.

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

Placement

get_placement_with_http_info(scope, code, as_at=None, property_keys=None, **kwargs)[source]

[EARLY ACCESS] GetPlacement: Get Placement # noqa: E501

Fetch a Placement that matches the specified identifier # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.get_placement_with_http_info(scope, code, as_at, property_keys, async_req=True)
>>> result = thread.get()
Parameters:
  • scope (str) – The scope to which the placement belongs. (required)

  • code (str) – The placement’s unique identifier. (required)

  • as_at (datetime) – The asAt datetime at which to retrieve the placement. Defaults to return the latest version of the placement if not specified.

  • property_keys (List[str]) – A list of property keys from the “Placement” domain to decorate onto the placement. If none are given, all applied properties are returned. These take the format {domain}/{scope}/{code} e.g. “Placement/system/Name”. Property keys from the instrument domain can also be decorated onto the placement, e.g. “Instrument/default/Isin”. These are only decorated if requested.

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _preload_content (bool, optional) – if False, the ApiResponse.data will be set to none and raw_data will store the HTTP response body without reading/decoding. Default is True.

  • _return_http_data_only (bool, optional) – response data instead of ApiResponse object with status code, headers, etc

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

tuple(Placement, status_code(int), headers(HTTPHeaderDict))

list_placements(as_at=None, page=None, sort_by=None, limit=None, filter=None, property_keys=None, async_req=None, **kwargs)[source]

[EARLY ACCESS] ListPlacements: List Placements # noqa: E501

Fetch the last pre-AsAt date version of each placement in scope (does not fetch the entire history). # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.list_placements(as_at, page, sort_by, limit, filter, property_keys, async_req=True)
>>> result = thread.get()
Parameters:
  • as_at (datetime) – The asAt datetime at which to retrieve the placement. Defaults to return the latest version of the placement if not specified.

  • page (str) – The pagination token to use to continue listing placements from a previous call to list placements. This value is returned from the previous call. If a pagination token is provided the sortBy, filter, effectiveAt, and asAt fields must not have changed since the original request.

  • sort_by (List[str]) – A list of field names or properties to sort by, each suffixed by “ ASC” or “ DESC”.

  • limit (int) – When paginating, limit the number of returned results to this many.

  • filter (str) – Expression to filter the result set. Read more about filtering results from LUSID here: https://support.lusid.com/filtering-results-from-lusid.

  • property_keys (List[str]) – A list of property keys from the “Placement” domain to decorate onto each placement. These take the format {domain}/{scope}/{code} e.g. “Placement/system/Name”.

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

PagedResourceListOfPlacement

list_placements_with_http_info(as_at=None, page=None, sort_by=None, limit=None, filter=None, property_keys=None, **kwargs)[source]

[EARLY ACCESS] ListPlacements: List Placements # noqa: E501

Fetch the last pre-AsAt date version of each placement in scope (does not fetch the entire history). # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.list_placements_with_http_info(as_at, page, sort_by, limit, filter, property_keys, async_req=True)
>>> result = thread.get()
Parameters:
  • as_at (datetime) – The asAt datetime at which to retrieve the placement. Defaults to return the latest version of the placement if not specified.

  • page (str) – The pagination token to use to continue listing placements from a previous call to list placements. This value is returned from the previous call. If a pagination token is provided the sortBy, filter, effectiveAt, and asAt fields must not have changed since the original request.

  • sort_by (List[str]) – A list of field names or properties to sort by, each suffixed by “ ASC” or “ DESC”.

  • limit (int) – When paginating, limit the number of returned results to this many.

  • filter (str) – Expression to filter the result set. Read more about filtering results from LUSID here: https://support.lusid.com/filtering-results-from-lusid.

  • property_keys (List[str]) – A list of property keys from the “Placement” domain to decorate onto each placement. These take the format {domain}/{scope}/{code} e.g. “Placement/system/Name”.

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _preload_content (bool, optional) – if False, the ApiResponse.data will be set to none and raw_data will store the HTTP response body without reading/decoding. Default is True.

  • _return_http_data_only (bool, optional) – response data instead of ApiResponse object with status code, headers, etc

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

tuple(PagedResourceListOfPlacement, status_code(int), headers(HTTPHeaderDict))

upsert_placements(placement_set_request=None, async_req=None, **kwargs)[source]

[EARLY ACCESS] UpsertPlacements: Upsert Placement # noqa: E501

Upsert; update existing placements with given ids, or create new placements otherwise. # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.upsert_placements(placement_set_request, async_req=True)
>>> result = thread.get()
Parameters:
  • placement_set_request (PlacementSetRequest) – The collection of placement requests.

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

ResourceListOfPlacement

upsert_placements_with_http_info(placement_set_request=None, **kwargs)[source]

[EARLY ACCESS] UpsertPlacements: Upsert Placement # noqa: E501

Upsert; update existing placements with given ids, or create new placements otherwise. # noqa: E501 This method makes a synchronous HTTP request by default. To make an asynchronous HTTP request, please pass async_req=True

>>> thread = api.upsert_placements_with_http_info(placement_set_request, async_req=True)
>>> result = thread.get()
Parameters:
  • placement_set_request (PlacementSetRequest) – The collection of placement requests.

  • async_req (bool, optional) – Whether to execute the request asynchronously.

  • _preload_content (bool, optional) – if False, the ApiResponse.data will be set to none and raw_data will store the HTTP response body without reading/decoding. Default is True.

  • _return_http_data_only (bool, optional) – response data instead of ApiResponse object with status code, headers, etc

  • _request_timeout – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

Returns:

Returns the result object. If the method is called asynchronously, returns the request thread.

Return type:

tuple(ResourceListOfPlacement, status_code(int), headers(HTTPHeaderDict))