Just a method documentation

Adds documentation to the method get_subcloud_by_name in the class DcManagerSubcloudListOutput.

Change-Id: Id4412246492a4d0ec01a56339bbf54d3231e2ee7
This commit is contained in:
Marcelo Daride Gaspar 2024-12-09 09:57:17 -03:00
parent ff12639e60
commit e267525cec

View File

@ -125,7 +125,7 @@ class DcManagerSubcloudListOutput:
def get_healthy_subcloud_with_lowest_id(self) -> DcManagerSubcloudListObject:
"""
Gets the instance of DcManagerSubcloudListObject with the lowest ID and that satisfies the criteria:
Gets an instance of DcManagerSubcloudListObject with the lowest ID and that satisfies the criteria:
_ Managed;
_ Online;
_ Deploy completed;
@ -148,6 +148,18 @@ class DcManagerSubcloudListOutput:
return lowest_subcloud
def get_subcloud_by_name(self, subcloud_name: str) -> DcManagerSubcloudListObject:
"""
Gets an instance of DcManagerSubcloudListObject whose name attribute is equal to the argument 'subcloud_name'.
Args:
subcloud_name (str): The name of the subcloud to be retrieved.
Returns:
DcManagerSubcloudListObject: An instance of DcManagerSubcloudListObject whose name attribute matches the
argument 'subcloud_name'. This instance represents a row from the output of the command
'dcmanager subcloud list' where the column 'name' matches the argument 'subcloud_name'.
"""
dcmanager_subcloud_list_object_filter = DcManagerSubcloudListObjectFilter()
dcmanager_subcloud_list_object_filter.set_name(subcloud_name)
subclouds = self.get_dcmanager_subcloud_list_objects_filtered(dcmanager_subcloud_list_object_filter)