/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
/*
* Do not modify this file. This file is generated from the codeguru-security-2018-05-10.normal.json service model.
*/
using System;
using System.Collections.Generic;
using Amazon.Runtime;
using Amazon.CodeGuruSecurity.Model;
namespace Amazon.CodeGuruSecurity
{
///
/// Interface for accessing CodeGuruSecurity
///
///
///
/// Amazon CodeGuru Security is in preview release and is subject to change.
///
///
///
/// This section provides documentation for the Amazon CodeGuru Security API operations.
/// CodeGuru Security is a service that uses program analysis and machine learning to
/// detect security policy violations and vulnerabilities, and recommends ways to address
/// these security risks.
///
///
///
/// By proactively detecting and providing recommendations for addressing security risks,
/// CodeGuru Security improves the overall security of your application code. For more
/// information about CodeGuru Security, see the Amazon
/// CodeGuru Security User Guide.
///
///
public partial interface IAmazonCodeGuruSecurity : IAmazonService, IDisposable
{
#if BCL45 || AWS_ASYNC_ENUMERABLES_API
///
/// Paginators for the service
///
ICodeGuruSecurityPaginatorFactory Paginators { get; }
#endif
#region BatchGetFindings
///
/// Returns a list of all requested findings.
///
/// Container for the necessary parameters to execute the BatchGetFindings service method.
///
/// The response from the BatchGetFindings service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for BatchGetFindings Operation
BatchGetFindingsResponse BatchGetFindings(BatchGetFindingsRequest request);
///
/// Initiates the asynchronous execution of the BatchGetFindings operation.
///
///
/// Container for the necessary parameters to execute the BatchGetFindings operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndBatchGetFindings
/// operation.
/// REST API Reference for BatchGetFindings Operation
IAsyncResult BeginBatchGetFindings(BatchGetFindingsRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the BatchGetFindings operation.
///
///
/// The IAsyncResult returned by the call to BeginBatchGetFindings.
///
/// Returns a BatchGetFindingsResult from CodeGuruSecurity.
/// REST API Reference for BatchGetFindings Operation
BatchGetFindingsResponse EndBatchGetFindings(IAsyncResult asyncResult);
#endregion
#region CreateScan
///
/// Use to create a scan using code uploaded to an S3 bucket.
///
/// Container for the necessary parameters to execute the CreateScan service method.
///
/// The response from the CreateScan service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The requested operation would cause a conflict with the current state of a service
/// resource associated with the request. Resolve the conflict before retrying this request.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The resource specified in the request was not found.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for CreateScan Operation
CreateScanResponse CreateScan(CreateScanRequest request);
///
/// Initiates the asynchronous execution of the CreateScan operation.
///
///
/// Container for the necessary parameters to execute the CreateScan operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndCreateScan
/// operation.
/// REST API Reference for CreateScan Operation
IAsyncResult BeginCreateScan(CreateScanRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the CreateScan operation.
///
///
/// The IAsyncResult returned by the call to BeginCreateScan.
///
/// Returns a CreateScanResult from CodeGuruSecurity.
/// REST API Reference for CreateScan Operation
CreateScanResponse EndCreateScan(IAsyncResult asyncResult);
#endregion
#region CreateUploadUrl
///
/// Generates a pre-signed URL and request headers used to upload a code resource.
///
///
///
/// You can upload your code resource to the URL and add the request headers using any
/// HTTP client.
///
///
/// Container for the necessary parameters to execute the CreateUploadUrl service method.
///
/// The response from the CreateUploadUrl service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for CreateUploadUrl Operation
CreateUploadUrlResponse CreateUploadUrl(CreateUploadUrlRequest request);
///
/// Initiates the asynchronous execution of the CreateUploadUrl operation.
///
///
/// Container for the necessary parameters to execute the CreateUploadUrl operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndCreateUploadUrl
/// operation.
/// REST API Reference for CreateUploadUrl Operation
IAsyncResult BeginCreateUploadUrl(CreateUploadUrlRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the CreateUploadUrl operation.
///
///
/// The IAsyncResult returned by the call to BeginCreateUploadUrl.
///
/// Returns a CreateUploadUrlResult from CodeGuruSecurity.
/// REST API Reference for CreateUploadUrl Operation
CreateUploadUrlResponse EndCreateUploadUrl(IAsyncResult asyncResult);
#endregion
#region GetAccountConfiguration
///
/// Use to get account level configuration.
///
/// Container for the necessary parameters to execute the GetAccountConfiguration service method.
///
/// The response from the GetAccountConfiguration service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for GetAccountConfiguration Operation
GetAccountConfigurationResponse GetAccountConfiguration(GetAccountConfigurationRequest request);
///
/// Initiates the asynchronous execution of the GetAccountConfiguration operation.
///
///
/// Container for the necessary parameters to execute the GetAccountConfiguration operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndGetAccountConfiguration
/// operation.
/// REST API Reference for GetAccountConfiguration Operation
IAsyncResult BeginGetAccountConfiguration(GetAccountConfigurationRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the GetAccountConfiguration operation.
///
///
/// The IAsyncResult returned by the call to BeginGetAccountConfiguration.
///
/// Returns a GetAccountConfigurationResult from CodeGuruSecurity.
/// REST API Reference for GetAccountConfiguration Operation
GetAccountConfigurationResponse EndGetAccountConfiguration(IAsyncResult asyncResult);
#endregion
#region GetFindings
///
/// Returns a list of all findings generated by a particular scan.
///
/// Container for the necessary parameters to execute the GetFindings service method.
///
/// The response from the GetFindings service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The requested operation would cause a conflict with the current state of a service
/// resource associated with the request. Resolve the conflict before retrying this request.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The resource specified in the request was not found.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for GetFindings Operation
GetFindingsResponse GetFindings(GetFindingsRequest request);
///
/// Initiates the asynchronous execution of the GetFindings operation.
///
///
/// Container for the necessary parameters to execute the GetFindings operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndGetFindings
/// operation.
/// REST API Reference for GetFindings Operation
IAsyncResult BeginGetFindings(GetFindingsRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the GetFindings operation.
///
///
/// The IAsyncResult returned by the call to BeginGetFindings.
///
/// Returns a GetFindingsResult from CodeGuruSecurity.
/// REST API Reference for GetFindings Operation
GetFindingsResponse EndGetFindings(IAsyncResult asyncResult);
#endregion
#region GetMetricsSummary
///
/// Returns top level metrics about an account from a specified date, including number
/// of open findings, the categories with most findings, the scans with most open findings,
/// and scans with most open critical findings.
///
/// Container for the necessary parameters to execute the GetMetricsSummary service method.
///
/// The response from the GetMetricsSummary service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for GetMetricsSummary Operation
GetMetricsSummaryResponse GetMetricsSummary(GetMetricsSummaryRequest request);
///
/// Initiates the asynchronous execution of the GetMetricsSummary operation.
///
///
/// Container for the necessary parameters to execute the GetMetricsSummary operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndGetMetricsSummary
/// operation.
/// REST API Reference for GetMetricsSummary Operation
IAsyncResult BeginGetMetricsSummary(GetMetricsSummaryRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the GetMetricsSummary operation.
///
///
/// The IAsyncResult returned by the call to BeginGetMetricsSummary.
///
/// Returns a GetMetricsSummaryResult from CodeGuruSecurity.
/// REST API Reference for GetMetricsSummary Operation
GetMetricsSummaryResponse EndGetMetricsSummary(IAsyncResult asyncResult);
#endregion
#region GetScan
///
/// Returns details about a scan, including whether or not a scan has completed.
///
/// Container for the necessary parameters to execute the GetScan service method.
///
/// The response from the GetScan service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The resource specified in the request was not found.
///
///
/// The request was denied due to request throttling.
///
/// REST API Reference for GetScan Operation
GetScanResponse GetScan(GetScanRequest request);
///
/// Initiates the asynchronous execution of the GetScan operation.
///
///
/// Container for the necessary parameters to execute the GetScan operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndGetScan
/// operation.
/// REST API Reference for GetScan Operation
IAsyncResult BeginGetScan(GetScanRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the GetScan operation.
///
///
/// The IAsyncResult returned by the call to BeginGetScan.
///
/// Returns a GetScanResult from CodeGuruSecurity.
/// REST API Reference for GetScan Operation
GetScanResponse EndGetScan(IAsyncResult asyncResult);
#endregion
#region ListFindingsMetrics
///
/// Returns metrics about all findings in an account within a specified time range.
///
/// Container for the necessary parameters to execute the ListFindingsMetrics service method.
///
/// The response from the ListFindingsMetrics service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for ListFindingsMetrics Operation
ListFindingsMetricsResponse ListFindingsMetrics(ListFindingsMetricsRequest request);
///
/// Initiates the asynchronous execution of the ListFindingsMetrics operation.
///
///
/// Container for the necessary parameters to execute the ListFindingsMetrics operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndListFindingsMetrics
/// operation.
/// REST API Reference for ListFindingsMetrics Operation
IAsyncResult BeginListFindingsMetrics(ListFindingsMetricsRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the ListFindingsMetrics operation.
///
///
/// The IAsyncResult returned by the call to BeginListFindingsMetrics.
///
/// Returns a ListFindingsMetricsResult from CodeGuruSecurity.
/// REST API Reference for ListFindingsMetrics Operation
ListFindingsMetricsResponse EndListFindingsMetrics(IAsyncResult asyncResult);
#endregion
#region ListScans
///
/// Returns a list of all the standard scans in an account. Does not return express scans.
///
/// Container for the necessary parameters to execute the ListScans service method.
///
/// The response from the ListScans service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for ListScans Operation
ListScansResponse ListScans(ListScansRequest request);
///
/// Initiates the asynchronous execution of the ListScans operation.
///
///
/// Container for the necessary parameters to execute the ListScans operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndListScans
/// operation.
/// REST API Reference for ListScans Operation
IAsyncResult BeginListScans(ListScansRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the ListScans operation.
///
///
/// The IAsyncResult returned by the call to BeginListScans.
///
/// Returns a ListScansResult from CodeGuruSecurity.
/// REST API Reference for ListScans Operation
ListScansResponse EndListScans(IAsyncResult asyncResult);
#endregion
#region ListTagsForResource
///
/// Returns a list of all tags associated with a scan.
///
/// Container for the necessary parameters to execute the ListTagsForResource service method.
///
/// The response from the ListTagsForResource service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The requested operation would cause a conflict with the current state of a service
/// resource associated with the request. Resolve the conflict before retrying this request.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The resource specified in the request was not found.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for ListTagsForResource Operation
ListTagsForResourceResponse ListTagsForResource(ListTagsForResourceRequest request);
///
/// Initiates the asynchronous execution of the ListTagsForResource operation.
///
///
/// Container for the necessary parameters to execute the ListTagsForResource operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndListTagsForResource
/// operation.
/// REST API Reference for ListTagsForResource Operation
IAsyncResult BeginListTagsForResource(ListTagsForResourceRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the ListTagsForResource operation.
///
///
/// The IAsyncResult returned by the call to BeginListTagsForResource.
///
/// Returns a ListTagsForResourceResult from CodeGuruSecurity.
/// REST API Reference for ListTagsForResource Operation
ListTagsForResourceResponse EndListTagsForResource(IAsyncResult asyncResult);
#endregion
#region TagResource
///
/// Use to add one or more tags to an existing scan.
///
/// Container for the necessary parameters to execute the TagResource service method.
///
/// The response from the TagResource service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The requested operation would cause a conflict with the current state of a service
/// resource associated with the request. Resolve the conflict before retrying this request.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The resource specified in the request was not found.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for TagResource Operation
TagResourceResponse TagResource(TagResourceRequest request);
///
/// Initiates the asynchronous execution of the TagResource operation.
///
///
/// Container for the necessary parameters to execute the TagResource operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndTagResource
/// operation.
/// REST API Reference for TagResource Operation
IAsyncResult BeginTagResource(TagResourceRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the TagResource operation.
///
///
/// The IAsyncResult returned by the call to BeginTagResource.
///
/// Returns a TagResourceResult from CodeGuruSecurity.
/// REST API Reference for TagResource Operation
TagResourceResponse EndTagResource(IAsyncResult asyncResult);
#endregion
#region UntagResource
///
/// Use to remove one or more tags from an existing scan.
///
/// Container for the necessary parameters to execute the UntagResource service method.
///
/// The response from the UntagResource service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The requested operation would cause a conflict with the current state of a service
/// resource associated with the request. Resolve the conflict before retrying this request.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The resource specified in the request was not found.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for UntagResource Operation
UntagResourceResponse UntagResource(UntagResourceRequest request);
///
/// Initiates the asynchronous execution of the UntagResource operation.
///
///
/// Container for the necessary parameters to execute the UntagResource operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndUntagResource
/// operation.
/// REST API Reference for UntagResource Operation
IAsyncResult BeginUntagResource(UntagResourceRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the UntagResource operation.
///
///
/// The IAsyncResult returned by the call to BeginUntagResource.
///
/// Returns a UntagResourceResult from CodeGuruSecurity.
/// REST API Reference for UntagResource Operation
UntagResourceResponse EndUntagResource(IAsyncResult asyncResult);
#endregion
#region UpdateAccountConfiguration
///
/// Use to update account-level configuration with an encryption key.
///
/// Container for the necessary parameters to execute the UpdateAccountConfiguration service method.
///
/// The response from the UpdateAccountConfiguration service method, as returned by CodeGuruSecurity.
///
/// You do not have sufficient access to perform this action.
///
///
/// The server encountered an internal error and is unable to complete the request.
///
///
/// The resource specified in the request was not found.
///
///
/// The request was denied due to request throttling.
///
///
/// The input fails to satisfy the specified constraints.
///
/// REST API Reference for UpdateAccountConfiguration Operation
UpdateAccountConfigurationResponse UpdateAccountConfiguration(UpdateAccountConfigurationRequest request);
///
/// Initiates the asynchronous execution of the UpdateAccountConfiguration operation.
///
///
/// Container for the necessary parameters to execute the UpdateAccountConfiguration operation on AmazonCodeGuruSecurityClient.
/// An AsyncCallback delegate that is invoked when the operation completes.
/// A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.
///
/// An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndUpdateAccountConfiguration
/// operation.
/// REST API Reference for UpdateAccountConfiguration Operation
IAsyncResult BeginUpdateAccountConfiguration(UpdateAccountConfigurationRequest request, AsyncCallback callback, object state);
///
/// Finishes the asynchronous execution of the UpdateAccountConfiguration operation.
///
///
/// The IAsyncResult returned by the call to BeginUpdateAccountConfiguration.
///
/// Returns a UpdateAccountConfigurationResult from CodeGuruSecurity.
/// REST API Reference for UpdateAccountConfiguration Operation
UpdateAccountConfigurationResponse EndUpdateAccountConfiguration(IAsyncResult asyncResult);
#endregion
}
}