Class: AWS::IAM::Client

Inherits:
Core::QueryClient show all
Defined in:
lib/aws/iam/client.rb

Overview

Client class for AWS Identity and Access Management (IAM).

Instance Attribute Summary

Attributes inherited from Core::Client

#config

Instance Method Summary collapse

Methods inherited from Core::Client

#initialize, #log_warning, #operations, operations, #with_http_handler, #with_options

Constructor Details

This class inherits a constructor from AWS::Core::Client

Instance Method Details

#add_role_to_instance_profile(options = {}) ⇒ Core::Response

Calls the AddRoleToInstanceProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_profile_name - required - (String) Name of the instance profile to update.
    • :role_name - required - (String) Name of the role to add.

Returns:




# File 'lib/aws/iam/client.rb', line 39

#add_user_to_group(options = {}) ⇒ Core::Response

Calls the AddUserToGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group to update.
    • :user_name - required - (String) Name of the user to add.

Returns:




# File 'lib/aws/iam/client.rb', line 48

#change_password(options = {}) ⇒ Core::Response

Calls the ChangePassword API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :old_password - required - (String)
    • :new_password - required - (String)

Returns:




# File 'lib/aws/iam/client.rb', line 56

#create_access_key(options = {}) ⇒ Core::Response

Calls the CreateAccessKey API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) The user name that the new key will belong to.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :access_key - (Hash)
      • :user_name - (String)
      • :access_key_id - (String)
      • :status - (String)
      • :secret_access_key - (String)
      • :create_date - (Time)



# File 'lib/aws/iam/client.rb', line 64

#create_account_alias(options = {}) ⇒ Core::Response

Calls the CreateAccountAlias API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :account_alias - required - (String) Name of the account alias to create.

Returns:




# File 'lib/aws/iam/client.rb', line 81

#create_group(options = {}) ⇒ Core::Response

Calls the CreateGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path - (String) The path to the group. For more information about paths, see Identifiers for IAM Entities in Using AWS Identity and Access Management. This parameter is optional. If it is not included, it defaults to a slash (/).
    • :group_name - required - (String) Name of the group to create. Do not include the path in this value.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :group - (Hash)
      • :path - (String)
      • :group_name - (String)
      • :group_id - (String)
      • :arn - (String)
      • :create_date - (Time)



# File 'lib/aws/iam/client.rb', line 89

#create_instance_profile(options = {}) ⇒ Core::Response

Calls the CreateInstanceProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_profile_name - required - (String) Name of the instance profile to create.
    • :path - (String) The path to the instance profile. For more information about paths, see Identifiers for IAM Entities in Using AWS Identity and Access Management. This parameter is optional. If it is not included, it defaults to a slash (/).

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_profile - (Hash)
      • :path - (String)
      • :instance_profile_name - (String)
      • :instance_profile_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :roles - (Array)
      • :path - (String)
      • :role_name - (String)
      • :role_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :assume_role_policy_document - (String)



# File 'lib/aws/iam/client.rb', line 110

#create_login_profile(options = {}) ⇒ Core::Response

Calls the CreateLoginProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user to create a password for.
    • :password - required - (String) The new password for the user name.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :login_profile - (Hash)
      • :user_name - (String)
      • :create_date - (Time)



# File 'lib/aws/iam/client.rb', line 138

#create_role(options = {}) ⇒ Core::Response

Calls the CreateRole API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path - (String) The path to the role. For more information about paths, see Identifiers for IAM Entities in Using AWS Identity and Access Management. This parameter is optional. If it is not included, it defaults to a slash (/).
    • :role_name - required - (String) Name of the role to create.
    • :assume_role_policy_document - required - (String) The policy that grants an entity permission to assume the role.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :role - (Hash)
      • :path - (String)
      • :role_name - (String)
      • :role_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :assume_role_policy_document - (String)



# File 'lib/aws/iam/client.rb', line 154

#create_user(options = {}) ⇒ Core::Response

Calls the CreateUser API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path - (String) The path for the user name. For more information about paths, see Identifiers for IAM Entities in Using AWS Identity and Access Management. This parameter is optional. If it is not included, it defaults to a slash (/).
    • :user_name - required - (String) Name of the user to create.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :user - (Hash)
      • :path - (String)
      • :user_name - (String)
      • :user_id - (String)
      • :arn - (String)
      • :create_date - (Time)



# File 'lib/aws/iam/client.rb', line 177

#create_virtual_mfa_device(options = {}) ⇒ Core::Response

Calls the CreateVirtualMFADevice API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path - (String) The path for the virtual MFA device. For more information about paths, see Identifiers for IAM Entities in Using AWS Identity and Access Management. This parameter is optional. If it is not included, it defaults to a slash (/).
    • :virtual_mfa_device_name - required - (String) The name of the virtual MFA device. Use with path to uniquely identify a virtual MFA device.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :virtual_mfa_device - (Hash)
      • :serial_number - (String)
      • :base_32_string_seed - (String)
      • :qr_code_png - (String)
      • :user - (Hash)
      • :path - (String)
      • :user_name - (String)
      • :user_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :enable_date - (Time)



# File 'lib/aws/iam/client.rb', line 197

#deactivate_mfa_device(options = {}) ⇒ Core::Response

Calls the DeactivateMFADevice API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user whose MFA device you want to deactivate.
    • :serial_number - required - (String) The serial number that uniquely identifies the MFA device. For virtual MFA devices, the serial number is the device ARN.

Returns:




# File 'lib/aws/iam/client.rb', line 224

#delete_access_key(options = {}) ⇒ Core::Response

Calls the DeleteAccessKey API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user whose key you want to delete.
    • :access_key_id - required - (String) The Access Key ID for the Access Key ID and Secret Access Key you want to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 235

#delete_account_alias(options = {}) ⇒ Core::Response

Calls the DeleteAccountAlias API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :account_alias - required - (String) Name of the account alias to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 245

#delete_account_password_policy(options = {}) ⇒ Core::Response

Calls the DeleteAccountPasswordPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {})

Returns:




# File 'lib/aws/iam/client.rb', line 253

#delete_group(options = {}) ⇒ Core::Response

Calls the DeleteGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 259

#delete_group_policy(options = {}) ⇒ Core::Response

Calls the DeleteGroupPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group the policy is associated with.
    • :policy_name - required - (String) Name of the policy document to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 266

#delete_instance_profile(options = {}) ⇒ Core::Response

Calls the DeleteInstanceProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_profile_name - required - (String) Name of the instance profile to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 276

#delete_login_profile(options = {}) ⇒ Core::Response

Calls the DeleteLoginProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user whose password you want to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 284

#delete_role(options = {}) ⇒ Core::Response

Calls the DeleteRole API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) Name of the role to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 292

#delete_role_policy(options = {}) ⇒ Core::Response

Calls the DeleteRolePolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) Name of the role the associated with the policy.
    • :policy_name - required - (String) Name of the policy document to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 299

#delete_server_certificate(options = {}) ⇒ Core::Response

Calls the DeleteServerCertificate API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :server_certificate_name - required - (String) The name of the server certificate you want to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 309

#delete_signing_certificate(options = {}) ⇒ Core::Response

Calls the DeleteSigningCertificate API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user the signing certificate belongs to.
    • :certificate_id - required - (String) ID of the signing certificate to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 317

#delete_user(options = {}) ⇒ Core::Response

Calls the DeleteUser API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 327

#delete_user_policy(options = {}) ⇒ Core::Response

Calls the DeleteUserPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user the policy is associated with.
    • :policy_name - required - (String) Name of the policy document to delete.

Returns:




# File 'lib/aws/iam/client.rb', line 334

#delete_virtual_mfa_device(options = {}) ⇒ Core::Response

Calls the DeleteVirtualMFADevice API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :serial_number - required - (String) The serial number that uniquely identifies the MFA device. For virtual MFA devices, the serial number is the same as the ARN.

Returns:




# File 'lib/aws/iam/client.rb', line 344

#enable_mfa_device(options = {}) ⇒ Core::Response

Calls the EnableMFADevice API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user for whom you want to enable the MFA device.
    • :serial_number - required - (String) The serial number that uniquely identifies the MFA device. For virtual MFA devices, the serial number is the device ARN.
    • :authentication_code_1 - required - (String) An authentication code emitted by the device.
    • :authentication_code_2 - required - (String) A subsequent authentication code emitted by the device.

Returns:




# File 'lib/aws/iam/client.rb', line 353

#get_account_password_policy(options = {}) ⇒ Core::Response

Calls the GetAccountPasswordPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {})

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :password_policy - (Hash)
      • :minimum_password_length - (Integer)
      • :require_symbols - (Boolean)
      • :require_numbers - (Boolean)
      • :require_uppercase_characters - (Boolean)
      • :require_lowercase_characters - (Boolean)
      • :allow_users_to_change_password - (Boolean)



# File 'lib/aws/iam/client.rb', line 368

#get_account_summary(options = {}) ⇒ Core::Response

Calls the GetAccountSummary API operation.

Parameters:

  • options (Hash) (defaults to: {})

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :summary_map - (Hash)



# File 'lib/aws/iam/client.rb', line 384

#get_group(options = {}) ⇒ Core::Response

Calls the GetGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of user names you want in the response. If there are additional user names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :group - (Hash)
      • :path - (String)
      • :group_name - (String)
      • :group_id - (String)
      • :arn - (String)
      • :create_date - (Time)
    • :users - (Array)
      • :path - (String)
      • :user_name - (String)
      • :user_id - (String)
      • :arn - (String)
      • :create_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 394

#get_group_policy(options = {}) ⇒ Core::Response

Calls the GetGroupPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group the policy is associated with.
    • :policy_name - required - (String) Name of the policy document to get.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :group_name - (String)
    • :policy_name - (String)
    • :policy_document - (String)



# File 'lib/aws/iam/client.rb', line 426

#get_instance_profile(options = {}) ⇒ Core::Response

Calls the GetInstanceProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_profile_name - required - (String) Name of the instance profile to get information about.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_profile - (Hash)
      • :path - (String)
      • :instance_profile_name - (String)
      • :instance_profile_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :roles - (Array)
      • :path - (String)
      • :role_name - (String)
      • :role_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :assume_role_policy_document - (String)



# File 'lib/aws/iam/client.rb', line 442

#get_login_profile(options = {}) ⇒ Core::Response

Calls the GetLoginProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user whose login profile you want to retrieve.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :login_profile - (Hash)
      • :user_name - (String)
      • :create_date - (Time)



# File 'lib/aws/iam/client.rb', line 466

#get_role(options = {}) ⇒ Core::Response

Calls the GetRole API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) Name of the role to get information about.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :role - (Hash)
      • :path - (String)
      • :role_name - (String)
      • :role_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :assume_role_policy_document - (String)



# File 'lib/aws/iam/client.rb', line 480

#get_role_policy(options = {}) ⇒ Core::Response

Calls the GetRolePolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) Name of the role associated with the policy.
    • :policy_name - required - (String) Name of the policy document to get.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :role_name - (String)
    • :policy_name - (String)
    • :policy_document - (String)



# File 'lib/aws/iam/client.rb', line 498

#get_server_certificate(options = {}) ⇒ Core::Response

Calls the GetServerCertificate API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :server_certificate_name - required - (String) The name of the server certificate you want to retrieve information about.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :server_certificate - (Hash)
      • :server_certificate_metadata - (Hash)
      • :path - (String)
      • :server_certificate_name - (String)
      • :server_certificate_id - (String)
      • :arn - (String)
      • :upload_date - (Time)
      • :certificate_body - (String)
      • :certificate_chain - (String)



# File 'lib/aws/iam/client.rb', line 514

#get_user(options = {}) ⇒ Core::Response

Calls the GetUser API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user to get information about. This parameter is optional. If it is not included, it defaults to the user making the request.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :user - (Hash)
      • :path - (String)
      • :user_name - (String)
      • :user_id - (String)
      • :arn - (String)
      • :create_date - (Time)



# File 'lib/aws/iam/client.rb', line 534

#get_user_policy(options = {}) ⇒ Core::Response

Calls the GetUserPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user who the policy is associated with.
    • :policy_name - required - (String) Name of the policy document to get.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :user_name - (String)
    • :policy_name - (String)
    • :policy_document - (String)



# File 'lib/aws/iam/client.rb', line 552

#list_access_keys(options = {}) ⇒ Core::Response

Calls the ListAccessKeys API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user.
    • :marker - (String) Use this parameter only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this parameter only when paginating results to indicate the maximum number of keys you want in the response. If there are additional keys beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :access_key_metadata - (Array)
      • :user_name - (String)
      • :access_key_id - (String)
      • :status - (String)
      • :create_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 568

#list_account_aliases(options = {}) ⇒ Core::Response

Calls the ListAccountAliases API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of account aliases you want in the response. If there are additional account aliases beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :account_aliases - (Array)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 593

#list_group_policies(options = {}) ⇒ Core::Response

Calls the ListGroupPolicies API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) The name of the group to list policies for.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of policy names you want in the response. If there are additional policy names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :policy_names - (Array)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 613

#list_groups(options = {}) ⇒ Core::Response

Calls the ListGroups API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path_prefix - (String) The path prefix for filtering the results. For example: /division_abc/subdivision_xyz/, which would get all groups whose path starts with /division_abc/subdivision_xyz/. This parameter is optional. If it is not included, it defaults to a slash (/), listing all groups.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of groups you want in the response. If there are additional groups beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :groups - (Array)
      • :path - (String)
      • :group_name - (String)
      • :group_id - (String)
      • :arn - (String)
      • :create_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 635

#list_groups_for_user(options = {}) ⇒ Core::Response

Calls the ListGroupsForUser API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) The name of the user to list groups for.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of groups you want in the response. If there are additional groups beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :groups - (Array)
      • :path - (String)
      • :group_name - (String)
      • :group_id - (String)
      • :arn - (String)
      • :create_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 665

#list_instance_profiles(options = {}) ⇒ Core::Response

Calls the ListInstanceProfiles API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path_prefix - (String) The path prefix for filtering the results. For example: /application_abc/component_xyz/, which would get all instance profiles whose path starts with /application_abc/component_xyz/. This parameter is optional. If it is not included, it defaults to a slash (/), listing all instance profiles.
    • :marker - (String) Use this parameter only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this parameter only when paginating results to indicate the maximum number of user names you want in the response. If there are additional user names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_profiles - (Array)
      • :path - (String)
      • :instance_profile_name - (String)
      • :instance_profile_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :roles - (Array)
      • :path - (String)
      • :role_name - (String)
      • :role_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :assume_role_policy_document - (String)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 692

#list_instance_profiles_for_role(options = {}) ⇒ Core::Response

Calls the ListInstanceProfilesForRole API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) The name of the role to list instance profiles for.
    • :marker - (String) Use this parameter only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this parameter only when paginating results to indicate the maximum number of user names you want in the response. If there are additional user names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_profiles - (Array)
      • :path - (String)
      • :instance_profile_name - (String)
      • :instance_profile_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :roles - (Array)
      • :path - (String)
      • :role_name - (String)
      • :role_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :assume_role_policy_document - (String)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 730

#list_mfa_devices(options = {}) ⇒ Core::Response

Calls the ListMFADevices API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user whose MFA devices you want to list.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of MFA devices you want in the response. If there are additional MFA devices beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :mfa_devices - (Array)
      • :user_name - (String)
      • :serial_number - (String)
      • :enable_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 764

#list_role_policies(options = {}) ⇒ Core::Response

Calls the ListRolePolicies API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) The name of the role to list policies for.
    • :marker - (String) Use this parameter only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this parameter only when paginating results to indicate the maximum number of user names you want in the response. If there are additional user names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :policy_names - (Array)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 789

#list_roles(options = {}) ⇒ Core::Response

Calls the ListRoles API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path_prefix - (String) The path prefix for filtering the results. For example: /application_abc/component_xyz/, which would get all roles whose path starts with /application_abc/component_xyz/. This parameter is optional. If it is not included, it defaults to a slash (/), listing all roles.
    • :marker - (String) Use this parameter only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this parameter only when paginating results to indicate the maximum number of user names you want in the response. If there are additional user names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :roles - (Array)
      • :path - (String)
      • :role_name - (String)
      • :role_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :assume_role_policy_document - (String)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 811

#list_server_certificates(options = {}) ⇒ Core::Response

Calls the ListServerCertificates API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path_prefix - (String) The path prefix for filtering the results. For example: /company/servercerts would get all server certificates for which the path starts with /company/servercerts. This parameter is optional. If it is not included, it defaults to a slash (/), listing all server certificates.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of server certificates you want in the response. If there are additional server certificates beyond the maximum you specify, the IsTruncated response element will be set to true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :server_certificate_metadata_list - (Array)
      • :path - (String)
      • :server_certificate_name - (String)
      • :server_certificate_id - (String)
      • :arn - (String)
      • :upload_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 842

#list_signing_certificates(options = {}) ⇒ Core::Response

Calls the ListSigningCertificates API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) The name of the user.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of certificate IDs you want in the response. If there are additional certificate IDs beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :certificates - (Array)
      • :user_name - (String)
      • :certificate_id - (String)
      • :certificate_body - (String)
      • :status - (String)
      • :upload_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 873

#list_user_policies(options = {}) ⇒ Core::Response

Calls the ListUserPolicies API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) The name of the user to list policies for.
    • :marker - (String) Use this only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this only when paginating results to indicate the maximum number of policy names you want in the response. If there are additional policy names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :policy_names - (Array)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 899

#list_users(options = {}) ⇒ Core::Response

Calls the ListUsers API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path_prefix - (String) The path prefix for filtering the results. For example: /division_abc/subdivision_xyz/, which would get all user names whose path starts with /division_abc/subdivision_xyz/. This parameter is optional. If it is not included, it defaults to a slash (/), listing all user names.
    • :marker - (String) Use this parameter only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this parameter only when paginating results to indicate the maximum number of user names you want in the response. If there are additional user names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :users - (Array)
      • :path - (String)
      • :user_name - (String)
      • :user_id - (String)
      • :arn - (String)
      • :create_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 921

#list_virtual_mfa_devices(options = {}) ⇒ Core::Response

Calls the ListVirtualMFADevices API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :assignment_status - (String) The status (unassigned or assigned) of the devices to list. If you do not specify an AssignmentStatus, the action defaults to Any which lists both assigned and unassigned virtual MFA devices.
    • :marker - (String) Use this parameter only when paginating results, and only in a subsequent request after you've received a response where the results are truncated. Set it to the value of the Marker element in the response you just received.
    • :max_items - (Integer) Use this parameter only when paginating results to indicate the maximum number of user names you want in the response. If there are additional user names beyond the maximum you specify, the IsTruncated response element is true .

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :virtual_mfa_devices - (Array)
      • :serial_number - (String)
      • :base_32_string_seed - (String)
      • :qr_code_png - (String)
      • :user - (Hash)
      • :path - (String)
      • :user_name - (String)
      • :user_id - (String)
      • :arn - (String)
      • :create_date - (Time)
      • :enable_date - (Time)
    • :is_truncated - (Boolean)
    • :marker - (String)



# File 'lib/aws/iam/client.rb', line 952

#put_group_policy(options = {}) ⇒ Core::Response

Calls the PutGroupPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group to associate the policy with.
    • :policy_name - required - (String) Name of the policy document.
    • :policy_document - required - (String) The policy document.

Returns:




# File 'lib/aws/iam/client.rb', line 986

#put_role_policy(options = {}) ⇒ Core::Response

Calls the PutRolePolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) Name of the role to associate the policy with.
    • :policy_name - required - (String) Name of the policy document.
    • :policy_document - required - (String) The policy document.

Returns:




# File 'lib/aws/iam/client.rb', line 996

#put_user_policy(options = {}) ⇒ Core::Response

Calls the PutUserPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user to associate the policy with.
    • :policy_name - required - (String) Name of the policy document.
    • :policy_document - required - (String) The policy document.

Returns:




# File 'lib/aws/iam/client.rb', line 1006

#remove_role_from_instance_profile(options = {}) ⇒ Core::Response

Calls the RemoveRoleFromInstanceProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_profile_name - required - (String) Name of the instance profile to update.
    • :role_name - required - (String) Name of the role to remove.

Returns:




# File 'lib/aws/iam/client.rb', line 1016

#remove_user_from_group(options = {}) ⇒ Core::Response

Calls the RemoveUserFromGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group to update.
    • :user_name - required - (String) Name of the user to remove.

Returns:




# File 'lib/aws/iam/client.rb', line 1025

#resync_mfa_device(options = {}) ⇒ Core::Response

Calls the ResyncMFADevice API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user whose MFA device you want to resynchronize.
    • :serial_number - required - (String) Serial number that uniquely identifies the MFA device.
    • :authentication_code_1 - required - (String) An authentication code emitted by the device.
    • :authentication_code_2 - required - (String) A subsequent authentication code emitted by the device.

Returns:




# File 'lib/aws/iam/client.rb', line 1033

#update_access_key(options = {}) ⇒ Core::Response

Calls the UpdateAccessKey API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user whose key you want to update.
    • :access_key_id - required - (String) The Access Key ID of the Secret Access Key you want to update.
    • :status - required - (String) The status you want to assign to the Secret Access Key. Active means the key can be used for API calls to AWS, while Inactive means the key cannot be used.

Returns:




# File 'lib/aws/iam/client.rb', line 1047

#update_account_password_policy(options = {}) ⇒ Core::Response

Calls the UpdateAccountPasswordPolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :minimum_password_length - (Integer)
    • :require_symbols - (Boolean)
    • :require_numbers - (Boolean)
    • :require_uppercase_characters - (Boolean)
    • :require_lowercase_characters - (Boolean)
    • :allow_users_to_change_password - (Boolean)

Returns:




# File 'lib/aws/iam/client.rb', line 1060

#update_assume_role_policy(options = {}) ⇒ Core::Response

Calls the UpdateAssumeRolePolicy API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :role_name - required - (String) Name of the role to update.
    • :policy_document - required - (String) The policy that grants an entity permission to assume the role.

Returns:




# File 'lib/aws/iam/client.rb', line 1072

#update_group(options = {}) ⇒ Core::Response

Calls the UpdateGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_name - required - (String) Name of the group to update. If you're changing the name of the group, this is the original name.
    • :new_path - (String) New path for the group. Only include this if changing the group's path.
    • :new_group_name - (String) New name for the group. Only include this if changing the group's name.

Returns:




# File 'lib/aws/iam/client.rb', line 1081

#update_login_profile(options = {}) ⇒ Core::Response

Calls the UpdateLoginProfile API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user whose password you want to update.
    • :password - (String) The new password for the user name.

Returns:




# File 'lib/aws/iam/client.rb', line 1094

#update_server_certificate(options = {}) ⇒ Core::Response

Calls the UpdateServerCertificate API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :server_certificate_name - required - (String) The name of the server certificate that you want to update.
    • :new_path - (String) The new path for the server certificate. Include this only if you are updating the server certificate's path.
    • :new_server_certificate_name - (String) The new name for the server certificate. Include this only if you are updating the server certificate's name.

Returns:




# File 'lib/aws/iam/client.rb', line 1103

#update_signing_certificate(options = {}) ⇒ Core::Response

Calls the UpdateSigningCertificate API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user the signing certificate belongs to.
    • :certificate_id - required - (String) The ID of the signing certificate you want to update.
    • :status - required - (String) The status you want to assign to the certificate. Active means the certificate can be used for API calls to AWS, while Inactive means the certificate cannot be used.

Returns:




# File 'lib/aws/iam/client.rb', line 1117

#update_user(options = {}) ⇒ Core::Response

Calls the UpdateUser API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - required - (String) Name of the user to update. If you're changing the name of the user, this is the original user name.
    • :new_path - (String) New path for the user. Include this parameter only if you're changing the user's path.
    • :new_user_name - (String) New name for the user. Include this parameter only if you're changing the user's name.

Returns:




# File 'lib/aws/iam/client.rb', line 1130

#upload_server_certificate(options = {}) ⇒ Core::Response

Calls the UploadServerCertificate API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :path - (String) The path for the server certificate. For more information about paths, see Identifiers for IAM Entities in Using AWS Identity and Access Management. This parameter is optional. If it is not included, it defaults to a slash (/).
    • :server_certificate_name - required - (String) The name for the server certificate. Do not include the path in this value.
    • :certificate_body - required - (String) The contents of the public key certificate in PEM-encoded format.
    • :private_key - required - (String) The contents of the private key in PEM-encoded format.
    • :certificate_chain - (String) The contents of the certificate chain. This is typically a concatenation of the PEM-encoded public key certificates of the chain.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :server_certificate_metadata - (Hash)
      • :path - (String)
      • :server_certificate_name - (String)
      • :server_certificate_id - (String)
      • :arn - (String)
      • :upload_date - (Time)



# File 'lib/aws/iam/client.rb', line 1143

#upload_signing_certificate(options = {}) ⇒ Core::Response

Calls the UploadSigningCertificate API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :user_name - (String) Name of the user the signing certificate is for.
    • :certificate_body - required - (String) The contents of the signing certificate.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :certificate - (Hash)
      • :user_name - (String)
      • :certificate_id - (String)
      • :certificate_body - (String)
      • :status - (String)
      • :upload_date - (Time)



# File 'lib/aws/iam/client.rb', line 1171