# SwaggerClient::ControlsApi All URIs are relative to *http://localhost:4010* Method | HTTP request | Description ------------- | ------------- | ------------- [**get_system_controls**](ControlsApi.md#get_system_controls) | **GET** /api/systems/{systemId}/controls | Get control information in a system for one or many controls [**update_control_by_system_id**](ControlsApi.md#update_control_by_system_id) | **PUT** /api/systems/{systemId}/controls | Update control information in a system for one or many controls # **get_system_controls** > ControlsResponseGet get_system_controls(system_id, opts) Get control information in a system for one or many controls Returns system control information for matching `systemId` path parameter ### Example ```ruby # load the gem require 'swagger_client' # setup authorization SwaggerClient.configure do |config| # Configure API key authorization: apikey config.api_key['api-key'] = 'YOUR API KEY' # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) #config.api_key_prefix['api-key'] = 'Bearer' # Configure API key authorization: mockType config.api_key['Prefer'] = 'YOUR API KEY' # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) #config.api_key_prefix['Prefer'] = 'Bearer' # Configure API key authorization: userid config.api_key['user-uid'] = 'YOUR API KEY' # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) #config.api_key_prefix['user-uid'] = 'Bearer' end api_instance = SwaggerClient::ControlsApi.new system_id = 56 # Integer | **System Id**: The unique system record identifier. opts = { acronyms: 'PM-6' # String | **Acronym**: The system acronym(s) being queried (single value or comma delimited values). } begin #Get control information in a system for one or many controls result = api_instance.get_system_controls(system_id, opts) p result rescue SwaggerClient::ApiError => e puts "Exception when calling ControlsApi->get_system_controls: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **system_id** | **Integer**| **System Id**: The unique system record identifier. | **acronyms** | **String**| **Acronym**: The system acronym(s) being queried (single value or comma delimited values). | [optional] [default to PM-6] ### Return type [**ControlsResponseGet**](ControlsResponseGet.md) ### Authorization [apikey](../README.md#apikey), [mockType](../README.md#mockType), [userid](../README.md#userid) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json # **update_control_by_system_id** > ControlsResponsePut update_control_by_system_id(bodysystem_id) Update control information in a system for one or many controls Update a Control for given `systemId`
**Request Body Required Fields** - `acronym` - `responsibleEntities` - `controlDesignation` - `estimatedCompletionDate` - `implementationNarrative` The following optional fields are required based on the Implementation Status `implementationStatus` value
| Value | Required Fields |--------------------------|--------------------------------------------------- | Planned or Implemented | `estimatedCompletionDate`, `responsibleEntities`, `slcmCriticality`, `slcmFrequency`, `slcmMethod`, `slcmReporting`, `slcmTracking`, `slcmComments` | Not Applicable | `naJustification`, `responsibleEntities` | Manually Inherited | `commonControlProvider`, `estimatedCompletionDate`, `responsibleEntities`, `slcmCriticality`, `slcmFrequency`, `slcmMethod`, `slcmReporting`, `slcmTracking`, `slcmComments` If the Implementation Status `implementationStatus` value is \"Inherited\", only the following fields can be updated: - `controlDesignation` - `commonnControlProvider` ### Example ```ruby # load the gem require 'swagger_client' # setup authorization SwaggerClient.configure do |config| # Configure API key authorization: apikey config.api_key['api-key'] = 'YOUR API KEY' # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) #config.api_key_prefix['api-key'] = 'Bearer' # Configure API key authorization: mockType config.api_key['Prefer'] = 'YOUR API KEY' # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) #config.api_key_prefix['Prefer'] = 'Bearer' # Configure API key authorization: userid config.api_key['user-uid'] = 'YOUR API KEY' # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) #config.api_key_prefix['user-uid'] = 'Bearer' end api_instance = SwaggerClient::ControlsApi.new body = SwaggerClient::ControlsRequestPutBody.new # ControlsRequestPutBody | Update an existing control by Id system_id = 56 # Integer | **System Id**: The unique system record identifier. begin #Update control information in a system for one or many controls result = api_instance.update_control_by_system_id(bodysystem_id) p result rescue SwaggerClient::ApiError => e puts "Exception when calling ControlsApi->update_control_by_system_id: #{e}" end ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**ControlsRequestPutBody**](ControlsRequestPutBody.md)| Update an existing control by Id | **system_id** | **Integer**| **System Id**: The unique system record identifier. | ### Return type [**ControlsResponsePut**](ControlsResponsePut.md) ### Authorization [apikey](../README.md#apikey), [mockType](../README.md#mockType), [userid](../README.md#userid) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json