flywheel-sdk 19.3.0rc2__py2.py3-none-any.whl → 19.4.0rc0__py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1575,6 +1575,110 @@ class SessionsApi(object):
1575
1575
  _request_out=params.get('_request_out'),
1576
1576
  collection_formats=collection_formats)
1577
1577
 
1578
+ def delete_sessions_by_query(self, body, **kwargs): # noqa: E501
1579
+ """Delete multiple sessions by query
1580
+
1581
+ Delete multiple sessions by query
1582
+ This method makes a synchronous HTTP request by default.
1583
+
1584
+ :param list[Filter] body: Query for containers to delete (required)
1585
+ :param ContainerDeleteReason delete_reason:
1586
+ :param bool async_: Perform the request asynchronously
1587
+ :return: DeletedResult
1588
+ """
1589
+ ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
1590
+ kwargs['_return_http_data_only'] = True
1591
+
1592
+ if kwargs.get('async_'):
1593
+ return self.delete_sessions_by_query_with_http_info(body, **kwargs) # noqa: E501
1594
+ else:
1595
+ (data) = self.delete_sessions_by_query_with_http_info(body, **kwargs) # noqa: E501
1596
+ if (
1597
+ data
1598
+ and hasattr(data, 'return_value')
1599
+ and not ignore_simplified_return_value
1600
+ ):
1601
+ return data.return_value()
1602
+ return data
1603
+
1604
+
1605
+ def delete_sessions_by_query_with_http_info(self, body, **kwargs): # noqa: E501
1606
+ """Delete multiple sessions by query
1607
+
1608
+ Delete multiple sessions by query
1609
+ This method makes a synchronous HTTP request by default.
1610
+
1611
+ :param list[Filter] body: Query for containers to delete (required)
1612
+ :param ContainerDeleteReason delete_reason:
1613
+ :param bool async_: Perform the request asynchronously
1614
+ :return: DeletedResult
1615
+ """
1616
+
1617
+ all_params = ['body','delete_reason',] # noqa: E501
1618
+ all_params.append('async_')
1619
+ all_params.append('_return_http_data_only')
1620
+ all_params.append('_preload_content')
1621
+ all_params.append('_request_timeout')
1622
+ all_params.append('_request_out')
1623
+
1624
+ params = locals()
1625
+ for key, val in six.iteritems(params['kwargs']):
1626
+ if key not in all_params:
1627
+ raise TypeError(
1628
+ "Got an unexpected keyword argument '%s'"
1629
+ " to method delete_sessions_by_query" % key
1630
+ )
1631
+ params[key] = val
1632
+ del params['kwargs']
1633
+ # verify the required parameter 'body' is set
1634
+ if ('body' not in params or
1635
+ params['body'] is None):
1636
+ raise ValueError("Missing the required parameter `body` when calling `delete_sessions_by_query`") # noqa: E501
1637
+
1638
+ collection_formats = {}
1639
+
1640
+ path_params = {}
1641
+
1642
+ query_params = []
1643
+ if 'delete_reason' in params:
1644
+ query_params.append(('delete_reason', params['delete_reason'])) # noqa: E501
1645
+
1646
+ header_params = {}
1647
+
1648
+ form_params = []
1649
+ local_var_files = {}
1650
+
1651
+ body_params = None
1652
+ if 'body' in params:
1653
+ body_params = params['body']
1654
+ # HTTP header `Accept`
1655
+ header_params['Accept'] = self.api_client.select_header_accept(
1656
+ ['application/json']) # noqa: E501
1657
+
1658
+ # HTTP header `Content-Type`
1659
+ header_params['Content-Type'] = self.api_client.select_header_content_type( # noqa: E501
1660
+ ['application/json']) # noqa: E501
1661
+
1662
+ # Authentication setting
1663
+ auth_settings = ['ApiKey'] # noqa: E501
1664
+
1665
+ return self.api_client.call_api(
1666
+ '/sessions/delete_by_query', 'DELETE',
1667
+ path_params,
1668
+ query_params,
1669
+ header_params,
1670
+ body=body_params,
1671
+ post_params=form_params,
1672
+ files=local_var_files,
1673
+ response_type='DeletedResult', # noqa: E501
1674
+ auth_settings=auth_settings,
1675
+ async_=params.get('async_'),
1676
+ _return_http_data_only=params.get('_return_http_data_only'),
1677
+ _preload_content=params.get('_preload_content', True),
1678
+ _request_timeout=params.get('_request_timeout'),
1679
+ _request_out=params.get('_request_out'),
1680
+ collection_formats=collection_formats)
1681
+
1578
1682
  def download_file_from_session(self, session_id, file_name, dest_file, **kwargs): # noqa: E501
1579
1683
  """Download a file.
1580
1684
 
@@ -1709,9 +1813,9 @@ class SessionsApi(object):
1709
1813
  collection_formats=collection_formats)
1710
1814
 
1711
1815
  def get_session_file_zip_info(self, session_id, file_name, **kwargs): # noqa: E501
1712
- """Download a file.
1816
+ """Retrieve the zip info of a child file by name.
1713
1817
 
1714
- Files can be downloaded directly from this endpoint with a valid \"Authorization\" header or via a ticket id. To generate a ticket: - Make a request with an empty \"ticket\" parameter and a valid \"Authorization\" header. The server will respond with a generated ticket id. - Make another request with the received ticket id in the \"ticket\" parameter. A valid \"Authorization\" header is no longer required. When \"view\" is true, [RFC7233](https://tools.ietf.org/html/rfc7233) range request headers are supported. When virus_scan feature is enabled the quarantined files only can be downloaded using signed urls otherwise it will return with a HTTP 400 response.
1818
+ Does not work on files whose names contain a forward slash.
1715
1819
  This method makes a synchronous HTTP request by default.
1716
1820
 
1717
1821
  :param str session_id: 24-character hex ID (required)
@@ -1744,9 +1848,9 @@ class SessionsApi(object):
1744
1848
 
1745
1849
 
1746
1850
  def get_session_file_zip_info_with_http_info(self, session_id, file_name, **kwargs): # noqa: E501
1747
- """Download a file.
1851
+ """Retrieve the zip info of a child file by name.
1748
1852
 
1749
- Files can be downloaded directly from this endpoint with a valid \"Authorization\" header or via a ticket id. To generate a ticket: - Make a request with an empty \"ticket\" parameter and a valid \"Authorization\" header. The server will respond with a generated ticket id. - Make another request with the received ticket id in the \"ticket\" parameter. A valid \"Authorization\" header is no longer required. When \"view\" is true, [RFC7233](https://tools.ietf.org/html/rfc7233) range request headers are supported. When virus_scan feature is enabled the quarantined files only can be downloaded using signed urls otherwise it will return with a HTTP 400 response.
1853
+ Does not work on files whose names contain a forward slash.
1750
1854
  This method makes a synchronous HTTP request by default.
1751
1855
 
1752
1856
  :param str session_id: 24-character hex ID (required)
@@ -1848,9 +1952,8 @@ class SessionsApi(object):
1848
1952
  collection_formats=collection_formats)
1849
1953
 
1850
1954
  def get_session_download_ticket(self, session_id, file_name, **kwargs): # noqa: E501
1851
- """Download a file.
1955
+ """Get a signed URL to download a named child file.
1852
1956
 
1853
- Files can be downloaded directly from this endpoint with a valid \"Authorization\" header or via a ticket id. To generate a ticket: - Make a request with an empty \"ticket\" parameter and a valid \"Authorization\" header. The server will respond with a generated ticket id. - Make another request with the received ticket id in the \"ticket\" parameter. A valid \"Authorization\" header is no longer required. When \"view\" is true, [RFC7233](https://tools.ietf.org/html/rfc7233) range request headers are supported. When virus_scan feature is enabled the quarantined files only can be downloaded using signed urls otherwise it will return with a HTTP 400 response.
1854
1957
  This method makes a synchronous HTTP request by default.
1855
1958
 
1856
1959
  :param str session_id: 24-character hex ID (required)
@@ -1883,9 +1986,8 @@ class SessionsApi(object):
1883
1986
 
1884
1987
 
1885
1988
  def get_session_download_ticket_with_http_info(self, session_id, file_name, **kwargs): # noqa: E501
1886
- """Download a file.
1989
+ """Get a signed URL to download a named child file.
1887
1990
 
1888
- Files can be downloaded directly from this endpoint with a valid \"Authorization\" header or via a ticket id. To generate a ticket: - Make a request with an empty \"ticket\" parameter and a valid \"Authorization\" header. The server will respond with a generated ticket id. - Make another request with the received ticket id in the \"ticket\" parameter. A valid \"Authorization\" header is no longer required. When \"view\" is true, [RFC7233](https://tools.ietf.org/html/rfc7233) range request headers are supported. When virus_scan feature is enabled the quarantined files only can be downloaded using signed urls otherwise it will return with a HTTP 400 response.
1889
1991
  This method makes a synchronous HTTP request by default.
1890
1992
 
1891
1993
  :param str session_id: 24-character hex ID (required)
@@ -2118,9 +2220,9 @@ class SessionsApi(object):
2118
2220
  collection_formats=collection_formats)
2119
2221
 
2120
2222
  def get_session_analysis_input_zip_info(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2121
- """Download analysis inputs with filter.
2223
+ """Retrieve the zip info of a child file by name.
2122
2224
 
2123
- If \"ticket\" query param is included and not empty, download inputs. If \"ticket\" query param is included and empty, create a ticket for matching inputs in the analysis. If no \"ticket\" query param is included, inputs will be downloaded directly.
2225
+ Does not work on files whose names contain a forward slash.
2124
2226
  This method makes a synchronous HTTP request by default.
2125
2227
 
2126
2228
  :param str session_id: 24-character hex ID (required)
@@ -2152,9 +2254,9 @@ class SessionsApi(object):
2152
2254
 
2153
2255
 
2154
2256
  def get_session_analysis_input_zip_info_with_http_info(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2155
- """Download analysis inputs with filter.
2257
+ """Retrieve the zip info of a child file by name.
2156
2258
 
2157
- If \"ticket\" query param is included and not empty, download inputs. If \"ticket\" query param is included and empty, create a ticket for matching inputs in the analysis. If no \"ticket\" query param is included, inputs will be downloaded directly.
2259
+ Does not work on files whose names contain a forward slash.
2158
2260
  This method makes a synchronous HTTP request by default.
2159
2261
 
2160
2262
  :param str session_id: 24-character hex ID (required)
@@ -2257,9 +2359,8 @@ class SessionsApi(object):
2257
2359
  collection_formats=collection_formats)
2258
2360
 
2259
2361
  def get_session_analysis_input_download_ticket(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2260
- """Download analysis inputs with filter.
2362
+ """Get a signed URL to download a named child file.
2261
2363
 
2262
- If \"ticket\" query param is included and not empty, download inputs. If \"ticket\" query param is included and empty, create a ticket for matching inputs in the analysis. If no \"ticket\" query param is included, inputs will be downloaded directly.
2263
2364
  This method makes a synchronous HTTP request by default.
2264
2365
 
2265
2366
  :param str session_id: 24-character hex ID (required)
@@ -2291,9 +2392,8 @@ class SessionsApi(object):
2291
2392
 
2292
2393
 
2293
2394
  def get_session_analysis_input_download_ticket_with_http_info(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2294
- """Download analysis inputs with filter.
2395
+ """Get a signed URL to download a named child file.
2295
2396
 
2296
- If \"ticket\" query param is included and not empty, download inputs. If \"ticket\" query param is included and empty, create a ticket for matching inputs in the analysis. If no \"ticket\" query param is included, inputs will be downloaded directly.
2297
2397
  This method makes a synchronous HTTP request by default.
2298
2398
 
2299
2399
  :param str session_id: 24-character hex ID (required)
@@ -2527,9 +2627,9 @@ class SessionsApi(object):
2527
2627
  collection_formats=collection_formats)
2528
2628
 
2529
2629
  def get_session_analysis_output_zip_info(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2530
- """Download analysis outputs with filter.
2630
+ """Retrieve the zip info of a child file by name.
2531
2631
 
2532
- If \"ticket\" query param is included and not empty, download outputs. If \"ticket\" query param is included and empty, create a ticket for matching outputs in the analysis. If no \"ticket\" query param is included, outputs will be downloaded directly.
2632
+ Does not work on files whose names contain a forward slash.
2533
2633
  This method makes a synchronous HTTP request by default.
2534
2634
 
2535
2635
  :param str session_id: 24-character hex ID (required)
@@ -2561,9 +2661,9 @@ class SessionsApi(object):
2561
2661
 
2562
2662
 
2563
2663
  def get_session_analysis_output_zip_info_with_http_info(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2564
- """Download analysis outputs with filter.
2664
+ """Retrieve the zip info of a child file by name.
2565
2665
 
2566
- If \"ticket\" query param is included and not empty, download outputs. If \"ticket\" query param is included and empty, create a ticket for matching outputs in the analysis. If no \"ticket\" query param is included, outputs will be downloaded directly.
2666
+ Does not work on files whose names contain a forward slash.
2567
2667
  This method makes a synchronous HTTP request by default.
2568
2668
 
2569
2669
  :param str session_id: 24-character hex ID (required)
@@ -2666,9 +2766,8 @@ class SessionsApi(object):
2666
2766
  collection_formats=collection_formats)
2667
2767
 
2668
2768
  def get_session_analysis_output_download_ticket(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2669
- """Download analysis outputs with filter.
2769
+ """Get a signed URL to download a named child file.
2670
2770
 
2671
- If \"ticket\" query param is included and not empty, download outputs. If \"ticket\" query param is included and empty, create a ticket for matching outputs in the analysis. If no \"ticket\" query param is included, outputs will be downloaded directly.
2672
2771
  This method makes a synchronous HTTP request by default.
2673
2772
 
2674
2773
  :param str session_id: 24-character hex ID (required)
@@ -2700,9 +2799,8 @@ class SessionsApi(object):
2700
2799
 
2701
2800
 
2702
2801
  def get_session_analysis_output_download_ticket_with_http_info(self, session_id, analysis_id, filename, **kwargs): # noqa: E501
2703
- """Download analysis outputs with filter.
2802
+ """Get a signed URL to download a named child file.
2704
2803
 
2705
- If \"ticket\" query param is included and not empty, download outputs. If \"ticket\" query param is included and empty, create a ticket for matching outputs in the analysis. If no \"ticket\" query param is included, outputs will be downloaded directly.
2706
2804
  This method makes a synchronous HTTP request by default.
2707
2805
 
2708
2806
  :param str session_id: 24-character hex ID (required)
@@ -2811,6 +2909,7 @@ class SessionsApi(object):
2811
2909
  :param bool exhaustive: Set to return a complete list regardless of permissions
2812
2910
  :param bool join_avatars: add name and avatar to notes
2813
2911
  :param JoinType join: join file origins
2912
+ :param bool include_all_info: Include all info in returned objects
2814
2913
  :param str user_id:
2815
2914
  :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
2816
2915
  :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
@@ -2847,6 +2946,7 @@ class SessionsApi(object):
2847
2946
  :param bool exhaustive: Set to return a complete list regardless of permissions
2848
2947
  :param bool join_avatars: add name and avatar to notes
2849
2948
  :param JoinType join: join file origins
2949
+ :param bool include_all_info: Include all info in returned objects
2850
2950
  :param str user_id:
2851
2951
  :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
2852
2952
  :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
@@ -2859,7 +2959,7 @@ class SessionsApi(object):
2859
2959
  :return: union[Page,list[SessionListOutput]]
2860
2960
  """
2861
2961
 
2862
- all_params = ['exhaustive','join_avatars','join','user_id','filter','sort','limit','skip','page','after_id','x_accept_feature',] # noqa: E501
2962
+ all_params = ['exhaustive','join_avatars','join','include_all_info','user_id','filter','sort','limit','skip','page','after_id','x_accept_feature',] # noqa: E501
2863
2963
  all_params.append('async_')
2864
2964
  all_params.append('_return_http_data_only')
2865
2965
  all_params.append('_preload_content')
@@ -2887,6 +2987,8 @@ class SessionsApi(object):
2887
2987
  query_params.append(('join_avatars', params['join_avatars'])) # noqa: E501
2888
2988
  if 'join' in params:
2889
2989
  query_params.append(('join', params['join'])) # noqa: E501
2990
+ if 'include_all_info' in params:
2991
+ query_params.append(('include_all_info', params['include_all_info'])) # noqa: E501
2890
2992
  if 'user_id' in params:
2891
2993
  query_params.append(('user_id', params['user_id'])) # noqa: E501
2892
2994
  if 'filter' in params:
@@ -3054,6 +3156,7 @@ class SessionsApi(object):
3054
3156
  :param str collection_id:
3055
3157
  :param bool exhaustive:
3056
3158
  :param JoinType join:
3159
+ :param bool include_all_info: Include all info in returned objects
3057
3160
  :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
3058
3161
  :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
3059
3162
  :param int limit: The maximum number of entries to return.
@@ -3090,6 +3193,7 @@ class SessionsApi(object):
3090
3193
  :param str collection_id:
3091
3194
  :param bool exhaustive:
3092
3195
  :param JoinType join:
3196
+ :param bool include_all_info: Include all info in returned objects
3093
3197
  :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
3094
3198
  :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
3095
3199
  :param int limit: The maximum number of entries to return.
@@ -3101,7 +3205,7 @@ class SessionsApi(object):
3101
3205
  :return: union[list[AcquisitionListOutput],Page]
3102
3206
  """
3103
3207
 
3104
- all_params = ['session_id','collection_id','exhaustive','join','filter','sort','limit','skip','page','after_id','x_accept_feature',] # noqa: E501
3208
+ all_params = ['session_id','collection_id','exhaustive','join','include_all_info','filter','sort','limit','skip','page','after_id','x_accept_feature',] # noqa: E501
3105
3209
  all_params.append('async_')
3106
3210
  all_params.append('_return_http_data_only')
3107
3211
  all_params.append('_preload_content')
@@ -3135,6 +3239,8 @@ class SessionsApi(object):
3135
3239
  query_params.append(('exhaustive', params['exhaustive'])) # noqa: E501
3136
3240
  if 'join' in params:
3137
3241
  query_params.append(('join', params['join'])) # noqa: E501
3242
+ if 'include_all_info' in params:
3243
+ query_params.append(('include_all_info', params['include_all_info'])) # noqa: E501
3138
3244
  if 'filter' in params:
3139
3245
  query_params.append(('filter', params['filter'])) # noqa: E501
3140
3246
  if 'sort' in params:
@@ -3197,6 +3303,7 @@ class SessionsApi(object):
3197
3303
  :param bool inflate_job:
3198
3304
  :param bool join_avatars:
3199
3305
  :param JoinType join:
3306
+ :param bool include_all_info: Include all info in returned objects
3200
3307
  :param list[str] x_accept_feature:
3201
3308
  :param bool async_: Perform the request asynchronously
3202
3309
  :return: union[Page,list[union[AnalysisListOutput,AnalysisListOutputInflatedJob]]]
@@ -3233,12 +3340,13 @@ class SessionsApi(object):
3233
3340
  :param bool inflate_job:
3234
3341
  :param bool join_avatars:
3235
3342
  :param JoinType join:
3343
+ :param bool include_all_info: Include all info in returned objects
3236
3344
  :param list[str] x_accept_feature:
3237
3345
  :param bool async_: Perform the request asynchronously
3238
3346
  :return: union[Page,list[union[AnalysisListOutput,AnalysisListOutputInflatedJob]]]
3239
3347
  """
3240
3348
 
3241
- all_params = ['cid','filter','sort','limit','skip','page','after_id','inflate_job','join_avatars','join','x_accept_feature',] # noqa: E501
3349
+ all_params = ['cid','filter','sort','limit','skip','page','after_id','inflate_job','join_avatars','join','include_all_info','x_accept_feature',] # noqa: E501
3242
3350
  all_params.append('async_')
3243
3351
  all_params.append('_return_http_data_only')
3244
3352
  all_params.append('_preload_content')
@@ -3284,6 +3392,8 @@ class SessionsApi(object):
3284
3392
  query_params.append(('join_avatars', params['join_avatars'])) # noqa: E501
3285
3393
  if 'join' in params:
3286
3394
  query_params.append(('join', params['join'])) # noqa: E501
3395
+ if 'include_all_info' in params:
3396
+ query_params.append(('include_all_info', params['include_all_info'])) # noqa: E501
3287
3397
 
3288
3398
  header_params = {}
3289
3399
  if 'x_accept_feature' in params:
@@ -3547,6 +3657,7 @@ class SessionsApi(object):
3547
3657
  :param str session_id: (required)
3548
3658
  :param list[str] states: filter results by job state
3549
3659
  :param list[str] tags: filter results by job tags
3660
+ :param bool include_all_info: Include all info in returned objects
3550
3661
  :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
3551
3662
  :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
3552
3663
  :param int limit: The maximum number of entries to return.
@@ -3582,6 +3693,7 @@ class SessionsApi(object):
3582
3693
  :param str session_id: (required)
3583
3694
  :param list[str] states: filter results by job state
3584
3695
  :param list[str] tags: filter results by job tags
3696
+ :param bool include_all_info: Include all info in returned objects
3585
3697
  :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
3586
3698
  :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
3587
3699
  :param int limit: The maximum number of entries to return.
@@ -3593,7 +3705,7 @@ class SessionsApi(object):
3593
3705
  :return: union[JobsList,Page]
3594
3706
  """
3595
3707
 
3596
- all_params = ['session_id','states','tags','filter','sort','limit','skip','page','after_id','x_accept_feature',] # noqa: E501
3708
+ all_params = ['session_id','states','tags','include_all_info','filter','sort','limit','skip','page','after_id','x_accept_feature',] # noqa: E501
3597
3709
  all_params.append('async_')
3598
3710
  all_params.append('_return_http_data_only')
3599
3711
  all_params.append('_preload_content')
@@ -3627,6 +3739,8 @@ class SessionsApi(object):
3627
3739
  if 'tags' in params:
3628
3740
  query_params.append(('tags', params['tags'])) # noqa: E501
3629
3741
  collection_formats['tags'] = 'multi' # noqa: E501
3742
+ if 'include_all_info' in params:
3743
+ query_params.append(('include_all_info', params['include_all_info'])) # noqa: E501
3630
3744
  if 'filter' in params:
3631
3745
  query_params.append(('filter', params['filter'])) # noqa: E501
3632
3746
  if 'sort' in params:
@@ -4491,7 +4605,7 @@ class SessionsApi(object):
4491
4605
  def modify_session_info(self, cid, body, **kwargs): # noqa: E501
4492
4606
  """Update or replace info for a(n) session.
4493
4607
 
4494
- Update or replace info for a(n) session.
4608
+ Update or replace info for a(n) session. Keys that contain '$' or '.' will be sanitized in the process of being updated on the container.
4495
4609
  This method makes a synchronous HTTP request by default.
4496
4610
 
4497
4611
  :param str cid: (required)
@@ -4518,7 +4632,7 @@ class SessionsApi(object):
4518
4632
  def modify_session_info_with_http_info(self, cid, body, **kwargs): # noqa: E501
4519
4633
  """Update or replace info for a(n) session.
4520
4634
 
4521
- Update or replace info for a(n) session.
4635
+ Update or replace info for a(n) session. Keys that contain '$' or '.' will be sanitized in the process of being updated on the container.
4522
4636
  This method makes a synchronous HTTP request by default.
4523
4637
 
4524
4638
  :param str cid: (required)