Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1422142107.7 KB

Returns details for an approval session. For more information, see <a href="https://docs.aws.amazon.com/mpa/latest/userguide/mpa-concepts.html">Session</a> in the <i>Multi-party approval User Guide</i>.

get/sessions/{SessionArn}

Path parameters

SessionArnstring required

Amazon Resource Name (ARN) for the session.

Response

Success

SessionArnstring

Amazon Resource Name (ARN) for the session.

ApprovalTeamArnstring

Amazon Resource Name (ARN) for the approval team.

ApprovalTeamNamestring

Name of the approval team.

ProtectedResourceArnstring

Amazon Resource Name (ARN) for the protected operation.

NumberOfApproversinteger

Total number of approvers in the session.

InitiationTimestring date-time

Timestamp when the session was initiated.

ExpirationTimestring date-time

Timestamp when the session will expire.

CompletionTimestring date-time

Timestamp when the session completed.

Descriptionstring password

Description for the session.

Metadataobject

Metadata for the session.

Status'PENDING' | 'CANCELLED' | 'APPROVED' | 'FAILED' | 'CREATING'

Status for the session. For example, if the team has approved the requested operation.

StatusCode'REJECTED' | 'EXPIRED' | 'CONFIGURATION_CHANGED' | 'ALL_APPROVERS_IN_SESSION'

Status code of the session.

StatusMessagestring

Message describing the status for session.

ExecutionStatus'EXECUTED' | 'FAILED' | 'PENDING'

Status for the protected operation. For example, if the operation is <code>PENDING</code>.

ActionNamestring

Name of the protected operation.

RequesterServicePrincipalstring

<a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#principal-services">Service principal</a> for the service associated with the protected operation.

RequesterPrincipalArnstring

<a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-request">IAM principal</a> that made the operation request.

RequesterAccountIdstring

ID for the account that made the operation request.

RequesterRegionstring

Amazon Web Services Region where the operation request originated.

RequesterCommentstring password

Message from the account that made the operation request

ActionCompletionStrategy'AUTO_COMPLETION_UPON_APPROVAL'

Strategy for executing the protected operation. <code>AUTO_COMPLETION_UPON_APPROVAL</code> means the operation is automatically executed using the requester's permissions, if approved.

AdditionalSecurityRequirementsAdditionalSecurityRequirement[]

A list of <code>AdditionalSecurityRequirement</code> applied to the session.

All 22 operations