AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a share request for a custom framework in Audit Manager.

The share request specifies a recipient and notifies them that a custom framework is available. Recipients have 120 days to accept or decline the request. If no action is taken, the share request expires.

When you create a share request, Audit Manager stores a snapshot of your custom framework in the US East (N. Virginia) Amazon Web Services Region. Audit Manager also stores a backup of the same snapshot in the US West (Oregon) Amazon Web Services Region.

Audit Manager deletes the snapshot and the backup snapshot when one of the following events occurs:

When a sender resends a share request, the snapshot is replaced with an updated version that corresponds with the latest version of the custom framework.

When a recipient accepts a share request, the snapshot is replicated into their Amazon Web Services account under the Amazon Web Services Region that was specified in the share request.

When you invoke the StartAssessmentFrameworkShare API, you are about to share a custom framework with another Amazon Web Services account. You may not share a custom framework that is derived from a standard framework if the standard framework is designated as not eligible for sharing by Amazon Web Services, unless you have obtained permission to do so from the owner of the standard framework. To learn more about which standard frameworks are eligible for sharing, see Framework sharing eligibility in the Audit Manager User Guide.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginStartAssessmentFrameworkShare and EndStartAssessmentFrameworkShare.

Namespace: Amazon.AuditManager
Assembly: AWSSDK.AuditManager.dll
Version: 3.x.y.z

Syntax

C#
public abstract Task<StartAssessmentFrameworkShareResponse> StartAssessmentFrameworkShareAsync(
         StartAssessmentFrameworkShareRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.AuditManager.Model.StartAssessmentFrameworkShareRequest

Container for the necessary parameters to execute the StartAssessmentFrameworkShare service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the StartAssessmentFrameworkShare service method, as returned by AuditManager.

Exceptions

ExceptionCondition
AccessDeniedException Your account isn't registered with Audit Manager. Check the delegated administrator setup on the Audit Manager settings page, and try again.
InternalServerException An internal service error occurred during the processing of your request. Try again later.
ResourceNotFoundException The resource that's specified in the request can't be found.
ValidationException The request has invalid or missing parameters.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also