Skip to content

Client

iam R Documentation

AWS Identity and Access Management

Description

Identity and Access Management

Identity and Access Management (IAM) is a web service for securely controlling access to Amazon Web Services services. With IAM, you can centrally manage users, security credentials such as access keys, and permissions that control which Amazon Web Services resources users and applications can access. For more information about IAM, see Identity and Access Management (IAM) and the Identity and Access Management User Guide.

Usage

iam(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

  • endpoint: The complete URL to use for the constructed client.

  • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. ⁠http://s3.amazonaws.com/BUCKET/KEY⁠.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- iam(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

add_client_id_to_open_id_connect_provider
Adds a new client ID (also known as audience) to the list of client IDs already registered for the specified IAM OpenID Connect (OIDC) provider resource
add_role_to_instance_profile
Adds the specified IAM role to the specified instance profile
add_user_to_group
Adds the specified user to the specified group
attach_group_policy
Attaches the specified managed policy to the specified IAM group
attach_role_policy
Attaches the specified managed policy to the specified IAM role
attach_user_policy
Attaches the specified managed policy to the specified user
change_password
Changes the password of the IAM user who is calling this operation
create_access_key
Creates a new Amazon Web Services secret access key and corresponding Amazon Web Services access key ID for the specified user
create_account_alias
Creates an alias for your Amazon Web Services account
create_group
Creates a new group
create_instance_profile
Creates a new instance profile
create_login_profile
Creates a password for the specified IAM user
create_open_id_connect_provider
Creates an IAM entity to describe an identity provider (IdP) that supports OpenID Connect (OIDC)
create_policy
Creates a new managed policy for your Amazon Web Services account
create_policy_version
Creates a new version of the specified managed policy
create_role
Creates a new role for your Amazon Web Services account
create_saml_provider
Creates an IAM resource that describes an identity provider (IdP) that supports SAML 2
create_service_linked_role
Creates an IAM role that is linked to a specific Amazon Web Services service
create_service_specific_credential
Generates a set of credentials consisting of a user name and password that can be used to access the service specified in the request
create_user
Creates a new IAM user for your Amazon Web Services account
create_virtual_mfa_device
Creates a new virtual MFA device for the Amazon Web Services account
deactivate_mfa_device
Deactivates the specified MFA device and removes it from association with the user name for which it was originally enabled
delete_access_key
Deletes the access key pair associated with the specified IAM user
delete_account_alias
Deletes the specified Amazon Web Services account alias
delete_account_password_policy
Deletes the password policy for the Amazon Web Services account
delete_group
Deletes the specified IAM group
delete_group_policy
Deletes the specified inline policy that is embedded in the specified IAM group
delete_instance_profile
Deletes the specified instance profile
delete_login_profile
Deletes the password for the specified IAM user, For more information, see Managing passwords for IAM users
delete_open_id_connect_provider
Deletes an OpenID Connect identity provider (IdP) resource object in IAM
delete_policy
Deletes the specified managed policy
delete_policy_version
Deletes the specified version from the specified managed policy
delete_role
Deletes the specified role
delete_role_permissions_boundary
Deletes the permissions boundary for the specified IAM role
delete_role_policy
Deletes the specified inline policy that is embedded in the specified IAM role
delete_saml_provider
Deletes a SAML provider resource in IAM
delete_server_certificate
Deletes the specified server certificate
delete_service_linked_role
Submits a service-linked role deletion request and returns a DeletionTaskId, which you can use to check the status of the deletion
delete_service_specific_credential
Deletes the specified service-specific credential
delete_signing_certificate
Deletes a signing certificate associated with the specified IAM user
delete_ssh_public_key
Deletes the specified SSH public key
delete_user
Deletes the specified IAM user
delete_user_permissions_boundary
Deletes the permissions boundary for the specified IAM user
delete_user_policy
Deletes the specified inline policy that is embedded in the specified IAM user
delete_virtual_mfa_device
Deletes a virtual MFA device
detach_group_policy
Removes the specified managed policy from the specified IAM group
detach_role_policy
Removes the specified managed policy from the specified role
detach_user_policy
Removes the specified managed policy from the specified user
enable_mfa_device
Enables the specified MFA device and associates it with the specified IAM user
generate_credential_report
Generates a credential report for the Amazon Web Services account
generate_organizations_access_report
Generates a report for service last accessed data for Organizations
generate_service_last_accessed_details
Generates a report that includes details about when an IAM resource (user, group, role, or policy) was last used in an attempt to access Amazon Web Services services
get_access_key_last_used
Retrieves information about when the specified access key was last used
get_account_authorization_details
Retrieves information about all IAM users, groups, roles, and policies in your Amazon Web Services account, including their relationships to one another
get_account_password_policy
Retrieves the password policy for the Amazon Web Services account
get_account_summary
Retrieves information about IAM entity usage and IAM quotas in the Amazon Web Services account
get_context_keys_for_custom_policy
Gets a list of all of the context keys referenced in the input policies
get_context_keys_for_principal_policy
Gets a list of all of the context keys referenced in all the IAM policies that are attached to the specified IAM entity
get_credential_report
Retrieves a credential report for the Amazon Web Services account
get_group
Returns a list of IAM users that are in the specified IAM group
get_group_policy
Retrieves the specified inline policy document that is embedded in the specified IAM group
get_instance_profile
Retrieves information about the specified instance profile, including the instance profile's path, GUID, ARN, and role
get_login_profile
Retrieves the user name for the specified IAM user
get_mfa_device
Retrieves information about an MFA device for a specified user
get_open_id_connect_provider
Returns information about the specified OpenID Connect (OIDC) provider resource object in IAM
get_organizations_access_report
Retrieves the service last accessed data report for Organizations that was previously generated using the GenerateOrganizationsAccessReport operation
get_policy
Retrieves information about the specified managed policy, including the policy's default version and the total number of IAM users, groups, and roles to which the policy is attached
get_policy_version
Retrieves information about the specified version of the specified managed policy, including the policy document
get_role
Retrieves information about the specified role, including the role's path, GUID, ARN, and the role's trust policy that grants permission to assume the role
get_role_policy
Retrieves the specified inline policy document that is embedded with the specified IAM role
get_saml_provider
Returns the SAML provider metadocument that was uploaded when the IAM SAML provider resource object was created or updated
get_server_certificate
Retrieves information about the specified server certificate stored in IAM
get_service_last_accessed_details
Retrieves a service last accessed report that was created using the GenerateServiceLastAccessedDetails operation
get_service_last_accessed_details_with_entities
After you generate a group or policy report using the GenerateServiceLastAccessedDetails operation, you can use the JobId parameter in GetServiceLastAccessedDetailsWithEntities
get_service_linked_role_deletion_status
Retrieves the status of your service-linked role deletion
get_ssh_public_key
Retrieves the specified SSH public key, including metadata about the key
get_user
Retrieves information about the specified IAM user, including the user's creation date, path, unique ID, and ARN
get_user_policy
Retrieves the specified inline policy document that is embedded in the specified IAM user
list_access_keys
Returns information about the access key IDs associated with the specified IAM user
list_account_aliases
Lists the account alias associated with the Amazon Web Services account (Note: you can have only one)
list_attached_group_policies
Lists all managed policies that are attached to the specified IAM group
list_attached_role_policies
Lists all managed policies that are attached to the specified IAM role
list_attached_user_policies
Lists all managed policies that are attached to the specified IAM user
list_entities_for_policy
Lists all IAM users, groups, and roles that the specified managed policy is attached to
list_group_policies
Lists the names of the inline policies that are embedded in the specified IAM group
list_groups
Lists the IAM groups that have the specified path prefix
list_groups_for_user
Lists the IAM groups that the specified IAM user belongs to
list_instance_profiles
Lists the instance profiles that have the specified path prefix
list_instance_profiles_for_role
Lists the instance profiles that have the specified associated IAM role
list_instance_profile_tags
Lists the tags that are attached to the specified IAM instance profile
list_mfa_devices
Lists the MFA devices for an IAM user
list_mfa_device_tags
Lists the tags that are attached to the specified IAM virtual multi-factor authentication (MFA) device
list_open_id_connect_providers
Lists information about the IAM OpenID Connect (OIDC) provider resource objects defined in the Amazon Web Services account
list_open_id_connect_provider_tags
Lists the tags that are attached to the specified OpenID Connect (OIDC)-compatible identity provider
list_policies
Lists all the managed policies that are available in your Amazon Web Services account, including your own customer-defined managed policies and all Amazon Web Services managed policies
list_policies_granting_service_access
Retrieves a list of policies that the IAM identity (user, group, or role) can use to access each specified service
list_policy_tags
Lists the tags that are attached to the specified IAM customer managed policy
list_policy_versions
Lists information about the versions of the specified managed policy, including the version that is currently set as the policy's default version
list_role_policies
Lists the names of the inline policies that are embedded in the specified IAM role
list_roles
Lists the IAM roles that have the specified path prefix
list_role_tags
Lists the tags that are attached to the specified role
list_saml_providers
Lists the SAML provider resource objects defined in IAM in the account
list_saml_provider_tags
Lists the tags that are attached to the specified Security Assertion Markup Language (SAML) identity provider
list_server_certificates
Lists the server certificates stored in IAM that have the specified path prefix
list_server_certificate_tags
Lists the tags that are attached to the specified IAM server certificate
list_service_specific_credentials
Returns information about the service-specific credentials associated with the specified IAM user
list_signing_certificates
Returns information about the signing certificates associated with the specified IAM user
list_ssh_public_keys
Returns information about the SSH public keys associated with the specified IAM user
list_user_policies
Lists the names of the inline policies embedded in the specified IAM user
list_users
Lists the IAM users that have the specified path prefix
list_user_tags
Lists the tags that are attached to the specified IAM user
list_virtual_mfa_devices
Lists the virtual MFA devices defined in the Amazon Web Services account by assignment status
put_group_policy
Adds or updates an inline policy document that is embedded in the specified IAM group
put_role_permissions_boundary
Adds or updates the policy that is specified as the IAM role's permissions boundary
put_role_policy
Adds or updates an inline policy document that is embedded in the specified IAM role
put_user_permissions_boundary
Adds or updates the policy that is specified as the IAM user's permissions boundary
put_user_policy
Adds or updates an inline policy document that is embedded in the specified IAM user
remove_client_id_from_open_id_connect_provider
Removes the specified client ID (also known as audience) from the list of client IDs registered for the specified IAM OpenID Connect (OIDC) provider resource object
remove_role_from_instance_profile
Removes the specified IAM role from the specified Amazon EC2 instance profile
remove_user_from_group
Removes the specified user from the specified group
reset_service_specific_credential
Resets the password for a service-specific credential
resync_mfa_device
Synchronizes the specified MFA device with its IAM resource object on the Amazon Web Services servers
set_default_policy_version
Sets the specified version of the specified policy as the policy's default (operative) version
set_security_token_service_preferences
Sets the specified version of the global endpoint token as the token version used for the Amazon Web Services account
simulate_custom_policy
Simulate how a set of IAM policies and optionally a resource-based policy works with a list of API operations and Amazon Web Services resources to determine the policies' effective permissions
simulate_principal_policy
Simulate how a set of IAM policies attached to an IAM entity works with a list of API operations and Amazon Web Services resources to determine the policies' effective permissions
tag_instance_profile
Adds one or more tags to an IAM instance profile
tag_mfa_device
Adds one or more tags to an IAM virtual multi-factor authentication (MFA) device
tag_open_id_connect_provider
Adds one or more tags to an OpenID Connect (OIDC)-compatible identity provider
tag_policy
Adds one or more tags to an IAM customer managed policy
tag_role
Adds one or more tags to an IAM role
tag_saml_provider
Adds one or more tags to a Security Assertion Markup Language (SAML) identity provider
tag_server_certificate
Adds one or more tags to an IAM server certificate
tag_user
Adds one or more tags to an IAM user
untag_instance_profile
Removes the specified tags from the IAM instance profile
untag_mfa_device
Removes the specified tags from the IAM virtual multi-factor authentication (MFA) device
untag_open_id_connect_provider
Removes the specified tags from the specified OpenID Connect (OIDC)-compatible identity provider in IAM
untag_policy
Removes the specified tags from the customer managed policy
untag_role
Removes the specified tags from the role
untag_saml_provider
Removes the specified tags from the specified Security Assertion Markup Language (SAML) identity provider in IAM
untag_server_certificate
Removes the specified tags from the IAM server certificate
untag_user
Removes the specified tags from the user
update_access_key
Changes the status of the specified access key from Active to Inactive, or vice versa
update_account_password_policy
Updates the password policy settings for the Amazon Web Services account
update_assume_role_policy
Updates the policy that grants an IAM entity permission to assume a role
update_group
Updates the name and/or the path of the specified IAM group
update_login_profile
Changes the password for the specified IAM user
update_open_id_connect_provider_thumbprint
Replaces the existing list of server certificate thumbprints associated with an OpenID Connect (OIDC) provider resource object with a new list of thumbprints
update_role
Updates the description or maximum session duration setting of a role
update_role_description
Use UpdateRole instead
update_saml_provider
Updates the metadata document for an existing SAML provider resource object
update_server_certificate
Updates the name and/or the path of the specified server certificate stored in IAM
update_service_specific_credential
Sets the status of a service-specific credential to Active or Inactive
update_signing_certificate
Changes the status of the specified user signing certificate from active to disabled, or vice versa
update_ssh_public_key
Sets the status of an IAM user's SSH public key to active or inactive
update_user
Updates the name and/or the path of the specified IAM user
upload_server_certificate
Uploads a server certificate entity for the Amazon Web Services account
upload_signing_certificate
Uploads an X
upload_ssh_public_key
Uploads an SSH public key and associates it with the specified IAM user

Examples

## Not run: 
svc <- iam()
# The following add-client-id-to-open-id-connect-provider command adds the
# client ID my-application-ID to the OIDC provider named
# server.example.com:
svc$add_client_id_to_open_id_connect_provider(
  ClientID = "my-application-ID",
  OpenIDConnectProviderArn = "arn:aws:iam::123456789012:oidc-provider/server.example.com"
)

## End(Not run)