Rolesanywhere

This page documents function available when using the Rolesanywhere module, created with @service Rolesanywhere.

Index

Documentation

Main.Rolesanywhere.create_profileMethod
create_profile(name, role_arns)
create_profile(name, role_arns, params::Dict{String,<:Any})

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.

Arguments

  • name: The name of the profile.
  • role_arns: A list of IAM roles that this profile can assume in a temporary credential request.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "durationSeconds": The number of seconds the vended session credentials are valid for.
  • "enabled": Specifies whether the profile is enabled.
  • "managedPolicyArns": A list of managed policy ARNs that apply to the vended session credentials.
  • "requireInstanceProperties": Specifies whether instance properties are required in temporary credential requests with this profile.
  • "sessionPolicy": A session policy that applies to the trust boundary of the vended session credentials.
  • "tags": The tags to attach to the profile.
Main.Rolesanywhere.create_trust_anchorMethod
create_trust_anchor(name, source)
create_trust_anchor(name, source, params::Dict{String,<:Any})

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.

Arguments

  • name: The name of the trust anchor.
  • source: The trust anchor type and its related certificate data.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "enabled": Specifies whether the trust anchor is enabled.
  • "notificationSettings": A list of notification settings to be associated to the trust anchor.
  • "tags": The tags to attach to the trust anchor.
Main.Rolesanywhere.delete_crlMethod
delete_crl(crl_id)
delete_crl(crl_id, params::Dict{String,<:Any})

Deletes a certificate revocation list (CRL). Required permissions: rolesanywhere:DeleteCrl.

Arguments

  • crl_id: The unique identifier of the certificate revocation list (CRL).
Main.Rolesanywhere.delete_profileMethod
delete_profile(profile_id)
delete_profile(profile_id, params::Dict{String,<:Any})

Deletes a profile. Required permissions: rolesanywhere:DeleteProfile.

Arguments

  • profile_id: The unique identifier of the profile.
Main.Rolesanywhere.delete_trust_anchorMethod
delete_trust_anchor(trust_anchor_id)
delete_trust_anchor(trust_anchor_id, params::Dict{String,<:Any})

Deletes a trust anchor. Required permissions: rolesanywhere:DeleteTrustAnchor.

Arguments

  • trust_anchor_id: The unique identifier of the trust anchor.
Main.Rolesanywhere.disable_crlMethod
disable_crl(crl_id)
disable_crl(crl_id, params::Dict{String,<:Any})

Disables a certificate revocation list (CRL). Required permissions: rolesanywhere:DisableCrl.

Arguments

  • crl_id: The unique identifier of the certificate revocation list (CRL).
Main.Rolesanywhere.disable_profileMethod
disable_profile(profile_id)
disable_profile(profile_id, params::Dict{String,<:Any})

Disables a profile. When disabled, temporary credential requests with this profile fail. Required permissions: rolesanywhere:DisableProfile.

Arguments

  • profile_id: The unique identifier of the profile.
Main.Rolesanywhere.disable_trust_anchorMethod
disable_trust_anchor(trust_anchor_id)
disable_trust_anchor(trust_anchor_id, params::Dict{String,<:Any})

Disables a trust anchor. When disabled, temporary credential requests specifying this trust anchor are unauthorized. Required permissions: rolesanywhere:DisableTrustAnchor.

Arguments

  • trust_anchor_id: The unique identifier of the trust anchor.
Main.Rolesanywhere.enable_crlMethod
enable_crl(crl_id)
enable_crl(crl_id, params::Dict{String,<:Any})

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

Arguments

  • crl_id: The unique identifier of the certificate revocation list (CRL).
Main.Rolesanywhere.enable_profileMethod
enable_profile(profile_id)
enable_profile(profile_id, params::Dict{String,<:Any})

Enables temporary credential requests for a profile. Required permissions: rolesanywhere:EnableProfile.

Arguments

  • profile_id: The unique identifier of the profile.
Main.Rolesanywhere.enable_trust_anchorMethod
enable_trust_anchor(trust_anchor_id)
enable_trust_anchor(trust_anchor_id, params::Dict{String,<:Any})

Enables a trust anchor. When enabled, certificates in the trust anchor chain are authorized for trust validation. Required permissions: rolesanywhere:EnableTrustAnchor.

Arguments

  • trust_anchor_id: The unique identifier of the trust anchor.
Main.Rolesanywhere.get_crlMethod
get_crl(crl_id)
get_crl(crl_id, params::Dict{String,<:Any})

Gets a certificate revocation list (CRL). Required permissions: rolesanywhere:GetCrl.

Arguments

  • crl_id: The unique identifier of the certificate revocation list (CRL).
Main.Rolesanywhere.get_profileMethod
get_profile(profile_id)
get_profile(profile_id, params::Dict{String,<:Any})

Gets a profile. Required permissions: rolesanywhere:GetProfile.

Arguments

  • profile_id: The unique identifier of the profile.
Main.Rolesanywhere.get_subjectMethod
get_subject(subject_id)
get_subject(subject_id, params::Dict{String,<:Any})

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.

Arguments

  • subject_id: The unique identifier of the subject.
Main.Rolesanywhere.get_trust_anchorMethod
get_trust_anchor(trust_anchor_id)
get_trust_anchor(trust_anchor_id, params::Dict{String,<:Any})

Gets a trust anchor. Required permissions: rolesanywhere:GetTrustAnchor.

Arguments

  • trust_anchor_id: The unique identifier of the trust anchor.
Main.Rolesanywhere.import_crlMethod
import_crl(crl_data, name, trust_anchor_arn)
import_crl(crl_data, name, trust_anchor_arn, params::Dict{String,<:Any})

Imports 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:ImportCrl.

Arguments

  • crl_data: The x509 v3 specified certificate revocation list (CRL).
  • name: The name of the certificate revocation list (CRL).
  • trust_anchor_arn: The ARN of the TrustAnchor the certificate revocation list (CRL) will provide revocation for.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "enabled": Specifies whether the certificate revocation list (CRL) is enabled.
  • "tags": A list of tags to attach to the certificate revocation list (CRL).
Main.Rolesanywhere.list_crlsMethod
list_crls()
list_crls(params::Dict{String,<:Any})

Lists all certificate revocation lists (CRL) in the authenticated account and Amazon Web Services Region. Required permissions: rolesanywhere:ListCrls.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "nextToken": A token that indicates where the output should continue from, if a previous request did not show all results. To get the next results, make the request again with this value.
  • "pageSize": The number of resources in the paginated list.
Main.Rolesanywhere.list_profilesMethod
list_profiles()
list_profiles(params::Dict{String,<:Any})

Lists all profiles in the authenticated account and Amazon Web Services Region. Required permissions: rolesanywhere:ListProfiles.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "nextToken": A token that indicates where the output should continue from, if a previous request did not show all results. To get the next results, make the request again with this value.
  • "pageSize": The number of resources in the paginated list.
Main.Rolesanywhere.list_subjectsMethod
list_subjects()
list_subjects(params::Dict{String,<:Any})

Lists the subjects in the authenticated account and Amazon Web Services Region. Required permissions: rolesanywhere:ListSubjects.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "nextToken": A token that indicates where the output should continue from, if a previous request did not show all results. To get the next results, make the request again with this value.
  • "pageSize": The number of resources in the paginated list.
Main.Rolesanywhere.list_tags_for_resourceMethod
list_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})

Lists the tags attached to the resource. Required permissions: rolesanywhere:ListTagsForResource.

Arguments

  • resource_arn: The ARN of the resource.
Main.Rolesanywhere.list_trust_anchorsMethod
list_trust_anchors()
list_trust_anchors(params::Dict{String,<:Any})

Lists the trust anchors in the authenticated account and Amazon Web Services Region. Required permissions: rolesanywhere:ListTrustAnchors.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "nextToken": A token that indicates where the output should continue from, if a previous request did not show all results. To get the next results, make the request again with this value.
  • "pageSize": The number of resources in the paginated list.
Main.Rolesanywhere.put_notification_settingsMethod
put_notification_settings(notification_settings, trust_anchor_id)
put_notification_settings(notification_settings, trust_anchor_id, params::Dict{String,<:Any})

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.

Arguments

  • notification_settings: A list of notification settings to be associated to the trust anchor.
  • trust_anchor_id: The unique identifier of the trust anchor.
Main.Rolesanywhere.reset_notification_settingsMethod
reset_notification_settings(notification_setting_keys, trust_anchor_id)
reset_notification_settings(notification_setting_keys, trust_anchor_id, params::Dict{String,<:Any})

Resets the custom notification setting to IAM Roles Anywhere default setting. Required permissions: rolesanywhere:ResetNotificationSettings.

Arguments

  • notification_setting_keys: A list of notification setting keys to reset. A notification setting key includes the event and the channel.
  • trust_anchor_id: The unique identifier of the trust anchor.
Main.Rolesanywhere.tag_resourceMethod
tag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})

Attaches tags to a resource. Required permissions: rolesanywhere:TagResource.

Arguments

  • resource_arn: The ARN of the resource.
  • tags: The tags to attach to the resource.
Main.Rolesanywhere.untag_resourceMethod
untag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})

Removes tags from the resource. Required permissions: rolesanywhere:UntagResource.

Arguments

  • resource_arn: The ARN of the resource.
  • tag_keys: A list of keys. Tag keys are the unique identifiers of tags.
Main.Rolesanywhere.update_crlMethod
update_crl(crl_id)
update_crl(crl_id, params::Dict{String,<:Any})

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.

Arguments

  • crl_id: The unique identifier of the certificate revocation list (CRL).

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "crlData": The x509 v3 specified certificate revocation list (CRL).
  • "name": The name of the Crl.
Main.Rolesanywhere.update_profileMethod
update_profile(profile_id)
update_profile(profile_id, params::Dict{String,<:Any})

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.

Arguments

  • profile_id: The unique identifier of the profile.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "durationSeconds": The number of seconds the vended session credentials are valid for.
  • "managedPolicyArns": A list of managed policy ARNs that apply to the vended session credentials.
  • "name": The name of the profile.
  • "roleArns": A list of IAM roles that this profile can assume in a temporary credential request.
  • "sessionPolicy": A session policy that applies to the trust boundary of the vended session credentials.
Main.Rolesanywhere.update_trust_anchorMethod
update_trust_anchor(trust_anchor_id)
update_trust_anchor(trust_anchor_id, params::Dict{String,<:Any})

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.

Arguments

  • trust_anchor_id: The unique identifier of the trust anchor.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "name": The name of the trust anchor.
  • "source": The trust anchor type and its related certificate data.