Skip to content

Commit

Permalink
Merge pull request #462 from sirosen/transferclient-doc7
Browse files Browse the repository at this point in the history
Add param docs for endpoint management methods
  • Loading branch information
sirosen committed Aug 26, 2021
2 parents cb99978 + ab1a299 commit a5cc503
Showing 1 changed file with 23 additions and 7 deletions.
30 changes: 23 additions & 7 deletions src/globus_sdk/services/transfer/client.py
Expand Up @@ -1440,9 +1440,7 @@ def task_skipped_errors(
>>> info["error_code"], info["source_path"]))
"""
task_id = utils.safe_stringify(task_id)
log.info(
"TransferClient.endpoint_manager_task_skipped_errors(%s, ...)", task_id
)
log.info("TransferClient.task_skipped_errors(%s, ...)", task_id)
resource_path = self.qjoin_path("task", task_id, "skipped_errors")
return IterableTransferResponse(
self.get(resource_path, query_params=query_params)
Expand All @@ -1460,9 +1458,12 @@ def endpoint_manager_monitored_endpoints(
self, query_params: Optional[Dict[str, Any]] = None
) -> IterableTransferResponse:
"""
``GET endpoint_manager/monitored_endpoints``
Get endpoints the current user is a monitor or manager on.
``GET endpoint_manager/monitored_endpoints``
:param query_params: Additional passthrough query parameters
:type query_params: dict, optional
"""
log.info(f"TransferClient.endpoint_manager_monitored_endpoints({query_params})")
path = self.qjoin_path("endpoint_manager", "monitored_endpoints")
Expand All @@ -1476,9 +1477,14 @@ def endpoint_manager_hosted_endpoint_list(
self, endpoint_id: UUIDLike, query_params: Optional[Dict[str, Any]] = None
) -> IterableTransferResponse:
"""
``GET /endpoint_manager/endpoint/<endpoint_id>/hosted_endpoint_list``
Get shared endpoints hosted on the given endpoint.
``GET /endpoint_manager/endpoint/<endpoint_id>/hosted_endpoint_list``
:param endpoint_id: The ID of the host endpoint
:type endpoint_id: str or UUID
:param query_params: Additional passthrough query parameters
:type query_params: dict, optional
"""
endpoint_id = utils.safe_stringify(endpoint_id)
log.info(f"TransferClient.endpoint_manager_hosted_endpoint_list({endpoint_id})")
Expand All @@ -1495,9 +1501,14 @@ def endpoint_manager_get_endpoint(
self, endpoint_id: UUIDLike, query_params: Optional[Dict[str, Any]] = None
) -> response.GlobusHTTPResponse:
"""
``GET /endpoint_manager/endpoint/<endpoint_id>``
Get endpoint details as an admin.
``GET /endpoint_manager/endpoint/<endpoint_id>``
:param endpoint_id: The ID of the endpoint
:type endpoint_id: str or UUID
:param query_params: Additional passthrough query parameters
:type query_params: dict, optional
"""
endpoint_id = utils.safe_stringify(endpoint_id)
log.info(f"TransferClient.endpoint_manager_get_endpoint({endpoint_id})")
Expand All @@ -1512,9 +1523,14 @@ def endpoint_manager_acl_list(
self, endpoint_id: UUIDLike, query_params: Optional[Dict[str, Any]] = None
) -> IterableTransferResponse:
"""
``GET endpoint_manager/endpoint/<endpoint_id>/access_list``
Get a list of access control rules on specified endpoint as an admin.
``GET endpoint_manager/endpoint/<endpoint_id>/access_list``
:param endpoint_id: The ID of the endpoint
:type endpoint_id: str or UUID
:param query_params: Additional passthrough query parameters
:type query_params: dict, optional
"""
endpoint_id = utils.safe_stringify(endpoint_id)
log.info(
Expand Down

0 comments on commit a5cc503

Please sign in to comment.