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.

Interface for accessing IAMRolesAnywhere

Identity and Access Management Roles Anywhere provides a secure way for your workloads such as servers, containers, and applications that run outside of Amazon Web Services to obtain temporary Amazon Web Services credentials. Your workloads can use the same IAM policies and roles you have for native Amazon Web Services applications to access Amazon Web Services resources. Using IAM Roles Anywhere eliminates the need to manage long-term credentials for workloads running outside of Amazon Web Services.

To use IAM Roles Anywhere, your workloads must use X.509 certificates issued by their certificate authority (CA). You register the CA with IAM Roles Anywhere as a trust anchor to establish trust between your public key infrastructure (PKI) and IAM Roles Anywhere. If you don't manage your own PKI system, you can use Private Certificate Authority to create a CA and then use that to establish trust with IAM Roles Anywhere.

This guide describes the IAM Roles Anywhere operations that you can call programmatically. For more information about IAM Roles Anywhere, see the IAM Roles Anywhere User Guide.

Inheritance Hierarchy

Amazon.IAMRolesAnywhere.IAmazonIAMRolesAnywhere

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

Syntax

C#
public interface IAmazonIAMRolesAnywhere
         IAmazonService, IDisposable

The IAmazonIAMRolesAnywhere type exposes the following members

Properties

NameTypeDescription
Public Property Paginators Amazon.IAMRolesAnywhere.Model.IIAMRolesAnywherePaginatorFactory

Paginators for the service

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.5 or higher. For .NET 3.5 the SDK follows the standard naming convention of BeginMethodName and EndMethodName to indicate asynchronous operations - these method pairs are not shown in the table below.

NameDescription
Public Method CreateProfile(CreateProfileRequest)

Creates a profile, a list of the roles that Roles Anywhere service is trusted to assume. You use profiles to intersect permissions with IAM managed policies.

Required permissions: rolesanywhere:CreateProfile.

Public Method CreateProfileAsync(CreateProfileRequest, CancellationToken)

Creates a profile, a list of the roles that Roles Anywhere service is trusted to assume. You use profiles to intersect permissions with IAM managed policies.

Required permissions: rolesanywhere:CreateProfile.

Public Method CreateTrustAnchor(CreateTrustAnchorRequest)

Creates a trust anchor to establish trust between IAM Roles Anywhere and your certificate authority (CA). You can define a trust anchor as a reference to an Private Certificate Authority (Private CA) or by uploading a CA certificate. Your Amazon Web Services workloads can authenticate with the trust anchor using certificates issued by the CA in exchange for temporary Amazon Web Services credentials.

Required permissions: rolesanywhere:CreateTrustAnchor.

Public Method CreateTrustAnchorAsync(CreateTrustAnchorRequest, CancellationToken)

Creates a trust anchor to establish trust between IAM Roles Anywhere and your certificate authority (CA). You can define a trust anchor as a reference to an Private Certificate Authority (Private CA) or by uploading a CA certificate. Your Amazon Web Services workloads can authenticate with the trust anchor using certificates issued by the CA in exchange for temporary Amazon Web Services credentials.

Required permissions: rolesanywhere:CreateTrustAnchor.

Public Method DeleteAttributeMapping(DeleteAttributeMappingRequest)

Delete an entry from the attribute mapping rules enforced by a given profile.

Public Method DeleteAttributeMappingAsync(DeleteAttributeMappingRequest, CancellationToken)

Delete an entry from the attribute mapping rules enforced by a given profile.

Public Method DeleteCrl(DeleteCrlRequest)

Deletes a certificate revocation list (CRL).

Required permissions: rolesanywhere:DeleteCrl.

Public Method DeleteCrlAsync(DeleteCrlRequest, CancellationToken)

Deletes a certificate revocation list (CRL).

Required permissions: rolesanywhere:DeleteCrl.

Public Method DeleteProfile(DeleteProfileRequest)

Deletes a profile.

Required permissions: rolesanywhere:DeleteProfile.

Public Method DeleteProfileAsync(DeleteProfileRequest, CancellationToken)

Deletes a profile.

Required permissions: rolesanywhere:DeleteProfile.

Public Method DeleteTrustAnchor(DeleteTrustAnchorRequest)

Deletes a trust anchor.

Required permissions: rolesanywhere:DeleteTrustAnchor.

Public Method DeleteTrustAnchorAsync(DeleteTrustAnchorRequest, CancellationToken)

Deletes a trust anchor.

Required permissions: rolesanywhere:DeleteTrustAnchor.

Public Method DetermineServiceOperationEndpoint(AmazonWebServiceRequest)

Returns the endpoint that will be used for a particular request.

Public Method DisableCrl(DisableCrlRequest)

Disables a certificate revocation list (CRL).

Required permissions: rolesanywhere:DisableCrl.

Public Method DisableCrlAsync(DisableCrlRequest, CancellationToken)

Disables a certificate revocation list (CRL).

Required permissions: rolesanywhere:DisableCrl.

Public Method DisableProfile(DisableProfileRequest)

Disables a profile. When disabled, temporary credential requests with this profile fail.

Required permissions: rolesanywhere:DisableProfile.

Public Method DisableProfileAsync(DisableProfileRequest, CancellationToken)

Disables a profile. When disabled, temporary credential requests with this profile fail.

Required permissions: rolesanywhere:DisableProfile.

Public Method DisableTrustAnchor(DisableTrustAnchorRequest)

Disables a trust anchor. When disabled, temporary credential requests specifying this trust anchor are unauthorized.

Required permissions: rolesanywhere:DisableTrustAnchor.

Public Method DisableTrustAnchorAsync(DisableTrustAnchorRequest, CancellationToken)

Disables a trust anchor. When disabled, temporary credential requests specifying this trust anchor are unauthorized.

Required permissions: rolesanywhere:DisableTrustAnchor.

Public Method EnableCrl(EnableCrlRequest)

Enables a certificate revocation list (CRL). When enabled, certificates stored in the CRL are unauthorized to receive session credentials.

Required permissions: rolesanywhere:EnableCrl.

Public Method EnableCrlAsync(EnableCrlRequest, CancellationToken)

Enables a certificate revocation list (CRL). When enabled, certificates stored in the CRL are unauthorized to receive session credentials.

Required permissions: rolesanywhere:EnableCrl.

Public Method EnableProfile(EnableProfileRequest)

Enables temporary credential requests for a profile.

Required permissions: rolesanywhere:EnableProfile.

Public Method EnableProfileAsync(EnableProfileRequest, CancellationToken)

Enables temporary credential requests for a profile.

Required permissions: rolesanywhere:EnableProfile.

Public Method EnableTrustAnchor(EnableTrustAnchorRequest)

Enables a trust anchor. When enabled, certificates in the trust anchor chain are authorized for trust validation.

Required permissions: rolesanywhere:EnableTrustAnchor.

Public Method EnableTrustAnchorAsync(EnableTrustAnchorRequest, CancellationToken)

Enables a trust anchor. When enabled, certificates in the trust anchor chain are authorized for trust validation.

Required permissions: rolesanywhere:EnableTrustAnchor.

Public Method GetCrl(GetCrlRequest)

Gets a certificate revocation list (CRL).

Required permissions: rolesanywhere:GetCrl.

Public Method GetCrlAsync(GetCrlRequest, CancellationToken)

Gets a certificate revocation list (CRL).

Required permissions: rolesanywhere:GetCrl.

Public Method GetProfile(GetProfileRequest)

Gets a profile.

Required permissions: rolesanywhere:GetProfile.

Public Method GetProfileAsync(GetProfileRequest, CancellationToken)

Gets a profile.

Required permissions: rolesanywhere:GetProfile.

Public Method GetSubject(GetSubjectRequest)

Gets a subject, which associates a certificate identity with authentication attempts. The subject stores auditing information such as the status of the last authentication attempt, the certificate data used in the attempt, and the last time the associated identity attempted authentication.

Required permissions: rolesanywhere:GetSubject.

Public Method GetSubjectAsync(GetSubjectRequest, CancellationToken)

Gets a subject, which associates a certificate identity with authentication attempts. The subject stores auditing information such as the status of the last authentication attempt, the certificate data used in the attempt, and the last time the associated identity attempted authentication.

Required permissions: rolesanywhere:GetSubject.

Public Method GetTrustAnchor(GetTrustAnchorRequest)

Gets a trust anchor.

Required permissions: rolesanywhere:GetTrustAnchor.

Public Method GetTrustAnchorAsync(GetTrustAnchorRequest, CancellationToken)

Gets a trust anchor.

Required permissions: rolesanywhere:GetTrustAnchor.

Public Method ImportCrl(ImportCrlRequest)

Imports the certificate revocation list (CRL). A CRL is a list of certificates that have been revoked by the issuing certificate Authority (CA).In order to be properly imported, a CRL must be in PEM format. IAM Roles Anywhere validates against the CRL before issuing credentials.

Required permissions: rolesanywhere:ImportCrl.

Public Method ImportCrlAsync(ImportCrlRequest, CancellationToken)

Imports the certificate revocation list (CRL). A CRL is a list of certificates that have been revoked by the issuing certificate Authority (CA).In order to be properly imported, a CRL must be in PEM format. IAM Roles Anywhere validates against the CRL before issuing credentials.

Required permissions: rolesanywhere:ImportCrl.

Public Method ListCrls(ListCrlsRequest)

Lists all certificate revocation lists (CRL) in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListCrls.

Public Method ListCrlsAsync(ListCrlsRequest, CancellationToken)

Lists all certificate revocation lists (CRL) in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListCrls.

Public Method ListProfiles(ListProfilesRequest)

Lists all profiles in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListProfiles.

Public Method ListProfilesAsync(ListProfilesRequest, CancellationToken)

Lists all profiles in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListProfiles.

Public Method ListSubjects(ListSubjectsRequest)

Lists the subjects in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListSubjects.

Public Method ListSubjectsAsync(ListSubjectsRequest, CancellationToken)

Lists the subjects in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListSubjects.

Public Method ListTagsForResource(ListTagsForResourceRequest)

Lists the tags attached to the resource.

Required permissions: rolesanywhere:ListTagsForResource.

Public Method ListTagsForResourceAsync(ListTagsForResourceRequest, CancellationToken)

Lists the tags attached to the resource.

Required permissions: rolesanywhere:ListTagsForResource.

Public Method ListTrustAnchors(ListTrustAnchorsRequest)

Lists the trust anchors in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListTrustAnchors.

Public Method ListTrustAnchorsAsync(ListTrustAnchorsRequest, CancellationToken)

Lists the trust anchors in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListTrustAnchors.

Public Method PutAttributeMapping(PutAttributeMappingRequest)

Put an entry in the attribute mapping rules that will be enforced by a given profile. A mapping specifies a certificate field and one or more specifiers that have contextual meanings.

Public Method PutAttributeMappingAsync(PutAttributeMappingRequest, CancellationToken)

Put an entry in the attribute mapping rules that will be enforced by a given profile. A mapping specifies a certificate field and one or more specifiers that have contextual meanings.

Public Method PutNotificationSettings(PutNotificationSettingsRequest)

Attaches a list of notification settings to a trust anchor.

A notification setting includes information such as event name, threshold, status of the notification setting, and the channel to notify.

Required permissions: rolesanywhere:PutNotificationSettings.

Public Method PutNotificationSettingsAsync(PutNotificationSettingsRequest, CancellationToken)

Attaches a list of notification settings to a trust anchor.

A notification setting includes information such as event name, threshold, status of the notification setting, and the channel to notify.

Required permissions: rolesanywhere:PutNotificationSettings.

Public Method ResetNotificationSettings(ResetNotificationSettingsRequest)

Resets the custom notification setting to IAM Roles Anywhere default setting.

Required permissions: rolesanywhere:ResetNotificationSettings.

Public Method ResetNotificationSettingsAsync(ResetNotificationSettingsRequest, CancellationToken)

Resets the custom notification setting to IAM Roles Anywhere default setting.

Required permissions: rolesanywhere:ResetNotificationSettings.

Public Method TagResource(TagResourceRequest)

Attaches tags to a resource.

Required permissions: rolesanywhere:TagResource.

Public Method TagResourceAsync(TagResourceRequest, CancellationToken)

Attaches tags to a resource.

Required permissions: rolesanywhere:TagResource.

Public Method UntagResource(UntagResourceRequest)

Removes tags from the resource.

Required permissions: rolesanywhere:UntagResource.

Public Method UntagResourceAsync(UntagResourceRequest, CancellationToken)

Removes tags from the resource.

Required permissions: rolesanywhere:UntagResource.

Public Method UpdateCrl(UpdateCrlRequest)

Updates the certificate revocation list (CRL). A CRL is a list of certificates that have been revoked by the issuing certificate authority (CA). IAM Roles Anywhere validates against the CRL before issuing credentials.

Required permissions: rolesanywhere:UpdateCrl.

Public Method UpdateCrlAsync(UpdateCrlRequest, CancellationToken)

Updates the certificate revocation list (CRL). A CRL is a list of certificates that have been revoked by the issuing certificate authority (CA). IAM Roles Anywhere validates against the CRL before issuing credentials.

Required permissions: rolesanywhere:UpdateCrl.

Public Method UpdateProfile(UpdateProfileRequest)

Updates a profile, a list of the roles that IAM Roles Anywhere service is trusted to assume. You use profiles to intersect permissions with IAM managed policies.

Required permissions: rolesanywhere:UpdateProfile.

Public Method UpdateProfileAsync(UpdateProfileRequest, CancellationToken)

Updates a profile, a list of the roles that IAM Roles Anywhere service is trusted to assume. You use profiles to intersect permissions with IAM managed policies.

Required permissions: rolesanywhere:UpdateProfile.

Public Method UpdateTrustAnchor(UpdateTrustAnchorRequest)

Updates a trust anchor. You establish trust between IAM Roles Anywhere and your certificate authority (CA) by configuring a trust anchor. You can define a trust anchor as a reference to an Private Certificate Authority (Private CA) or by uploading a CA certificate. Your Amazon Web Services workloads can authenticate with the trust anchor using certificates issued by the CA in exchange for temporary Amazon Web Services credentials.

Required permissions: rolesanywhere:UpdateTrustAnchor.

Public Method UpdateTrustAnchorAsync(UpdateTrustAnchorRequest, CancellationToken)

Updates a trust anchor. You establish trust between IAM Roles Anywhere and your certificate authority (CA) by configuring a trust anchor. You can define a trust anchor as a reference to an Private Certificate Authority (Private CA) or by uploading a CA certificate. Your Amazon Web Services workloads can authenticate with the trust anchor using certificates issued by the CA in exchange for temporary Amazon Web Services credentials.

Required permissions: rolesanywhere:UpdateTrustAnchor.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer, 3.5