/// <summary>
/// This operation allows you to request changes for your entities. Within a single ChangeSet,
/// you cannot start the same change type against the same entity multiple times. Additionally,
/// when a ChangeSet is running, all the entities targeted by the different changes are
/// locked until the ChangeSet has completed (either succeeded, cancelled, or failed).
/// If you try to start a ChangeSet containing a change against an entity that is already
/// locked, you will receive a <code>ResourceInUseException</code>.
///
///
/// <para>
/// For example, you cannot start the ChangeSet described in the <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_StartChangeSet.html#API_StartChangeSet_Examples">example</a>
/// later in this topic, because it contains two changes to execute the same change type
/// (<code>AddRevisions</code>) against the same entity (<code>entity-id@1)</code>.
/// </para>
///
/// <para>
/// For more information about working with change sets, see <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets">
/// Working with change sets</a>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the StartChangeSet service method.</param>
///
/// <returns>The response from the StartChangeSet service method, as returned by MarketplaceCatalog.</returns>
/// <exception cref="Amazon.MarketplaceCatalog.Model.AccessDeniedException">
/// Access is denied.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.InternalServiceException">
/// There was an internal service exception.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ResourceInUseException">
/// The resource is currently in use.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ResourceNotFoundException">
/// The specified resource wasn't found.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ServiceQuotaExceededException">
/// The maximum number of open requests per account has been exceeded.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ThrottlingException">
/// Too many requests.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ValidationException">
/// An error occurred during validation.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/marketplace-catalog-2018-09-17/StartChangeSet">REST API Reference for StartChangeSet Operation</seealso>
public virtual StartChangeSetResponse StartChangeSet(StartChangeSetRequest request)
{
var options = new InvokeOptions();
options.RequestMarshaller = StartChangeSetRequestMarshaller.Instance;
options.ResponseUnmarshaller = StartChangeSetResponseUnmarshaller.Instance;
return(Invoke <StartChangeSetResponse>(request, options));
}
/// <summary>
/// This operation allows you to request changes for your entities. Within a single ChangeSet,
/// you cannot start the same change type against the same entity multiple times. Additionally,
/// when a ChangeSet is running, all the entities targeted by the different changes are
/// locked until the ChangeSet has completed (either succeeded, cancelled, or failed).
/// If you try to start a ChangeSet containing a change against an entity that is already
/// locked, you will receive a <code>ResourceInUseException</code>.
///
///
/// <para>
/// For example, you cannot start the ChangeSet described in the <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/API_StartChangeSet.html#API_StartChangeSet_Examples">example</a>
/// later in this topic, because it contains two changes to execute the same change type
/// (<code>AddRevisions</code>) against the same entity (<code>entity-id@1)</code>.
/// </para>
///
/// <para>
/// For more information about working with change sets, see <a href="https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets">
/// Working with change sets</a>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the StartChangeSet service method.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
///
/// <returns>The response from the StartChangeSet service method, as returned by MarketplaceCatalog.</returns>
/// <exception cref="Amazon.MarketplaceCatalog.Model.AccessDeniedException">
/// Access is denied.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.InternalServiceException">
/// There was an internal service exception.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ResourceInUseException">
/// The resource is currently in use.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ResourceNotFoundException">
/// The specified resource wasn't found.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ServiceQuotaExceededException">
/// The maximum number of open requests per account has been exceeded.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ThrottlingException">
/// Too many requests.
/// </exception>
/// <exception cref="Amazon.MarketplaceCatalog.Model.ValidationException">
/// An error occurred during validation.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/marketplace-catalog-2018-09-17/StartChangeSet">REST API Reference for StartChangeSet Operation</seealso>
public virtual Task <StartChangeSetResponse> StartChangeSetAsync(StartChangeSetRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var options = new InvokeOptions();
options.RequestMarshaller = StartChangeSetRequestMarshaller.Instance;
options.ResponseUnmarshaller = StartChangeSetResponseUnmarshaller.Instance;
return(InvokeAsync <StartChangeSetResponse>(request, options, cancellationToken));
}
/// <summary>
/// Initiates the asynchronous execution of the StartChangeSet operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the StartChangeSet operation on AmazonMarketplaceCatalogClient.</param>
/// <param name="callback">An AsyncCallback delegate that is invoked when the operation completes.</param>
/// <param name="state">A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.</param>
///
/// <returns>An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndStartChangeSet
/// operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/marketplace-catalog-2018-09-17/StartChangeSet">REST API Reference for StartChangeSet Operation</seealso>
public virtual IAsyncResult BeginStartChangeSet(StartChangeSetRequest request, AsyncCallback callback, object state)
{
var options = new InvokeOptions();
options.RequestMarshaller = StartChangeSetRequestMarshaller.Instance;
options.ResponseUnmarshaller = StartChangeSetResponseUnmarshaller.Instance;
return(BeginInvoke(request, options, callback, state));
}
