Class: Aws::IAM::Types::Policy

Inherits:

Struct

• Object
• Struct
• Aws::IAM::Types::Policy

Includes:

Structure

Defined in:

lib/aws-sdk-iam/types.rb

Overview

Contains information about a managed policy.

This data type is used as a response element in the CreatePolicy, GetPolicy, and ListPolicies operations.

For more information about managed policies, refer to [Managed Policies and Inline Policies] in the *Using IAM* guide.

[1]: docs.aws.amazon.com/IAM/latest/UserGuide/policies-managed-vs-inline.html

See Also:

• AWS API Documentation

Instance Attribute Summary

• #arn ⇒ String

  The Amazon Resource Name (ARN).

• #attachment_count ⇒ Integer

  The number of entities (users, groups, and roles) that the policy is attached to.

• #create_date ⇒ Time

  The date and time, in [ISO 8601 date-time format], when the policy was created.

• #default_version_id ⇒ String

  The identifier for the version of the policy that is set as the default version.

• #description ⇒ String

  A friendly description of the policy.

• #is_attachable ⇒ Boolean

  Specifies whether the policy can be attached to an IAM user, group, or role.

• #path ⇒ String

  The path to the policy.

• #permissions_boundary_usage_count ⇒ Integer

  The number of entities (users and roles) for which the policy is used to set the permissions boundary.

• #policy_id ⇒ String

  The stable and unique string identifying the policy.

• #policy_name ⇒ String

  The friendly name (not ARN) identifying the policy.

• #update_date ⇒ Time

  The date and time, in [ISO 8601 date-time format], when the policy was last updated.

Instance Attribute Details

#arn ⇒ String

The Amazon Resource Name (ARN). ARNs are unique identifiers for AWS resources.

For more information about ARNs, go to [Amazon Resource Names (ARNs) and AWS Service Namespaces] in the *AWS General Reference*.

[1]: docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html

Returns:

• (String)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#attachment_count ⇒ Integer

The number of entities (users, groups, and roles) that the policy is attached to.

Returns:

• (Integer)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#create_date ⇒ Time

The date and time, in [ISO 8601 date-time format], when the policy was created.

[1]: www.iso.org/iso/iso8601

Returns:

• (Time)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#default_version_id ⇒ String

The identifier for the version of the policy that is set as the default version.

Returns:

• (String)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#description ⇒ String

A friendly description of the policy.

This element is included in the response to the GetPolicy operation. It is not included in the response to the ListPolicies operation.

Returns:

• (String)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#is_attachable ⇒ Boolean

Specifies whether the policy can be attached to an IAM user, group, or role.

Returns:

• (Boolean)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#path ⇒ String

The path to the policy.

For more information about paths, see [IAM Identifiers] in the *Using IAM* guide.

[1]: docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html

Returns:

• (String)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#permissions_boundary_usage_count ⇒ Integer

The number of entities (users and roles) for which the policy is used to set the permissions boundary.

For more information about permissions boundaries, see [Permissions Boundaries for IAM Identities ][1] in the *IAM User Guide*.

[1]: docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html

Returns:

• (Integer)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#policy_id ⇒ String

The stable and unique string identifying the policy.

For more information about IDs, see [IAM Identifiers] in the *Using IAM* guide.

[1]: docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html

Returns:

• (String)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#policy_name ⇒ String

The friendly name (not ARN) identifying the policy.

Returns:

• (String)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end

#update_date ⇒ Time

The date and time, in [ISO 8601 date-time format], when the policy was last updated.

When a policy has only one version, this field contains the date and time when the policy was created. When a policy has more than one version, this field contains the date and time when the most recent policy version was created.

[1]: www.iso.org/iso/iso8601

Returns:

• (Time)

# File 'lib/aws-sdk-iam/types.rb', line 6582

class Policy < Struct.new(
  :policy_name,
  :policy_id,
  :arn,
  :path,
  :default_version_id,
  :attachment_count,
  :permissions_boundary_usage_count,
  :is_attachable,
  :description,
  :create_date,
  :update_date)
  include Aws::Structure
end