Network.AWS.IAM.CreatePolicyVersion

Creates a new version of the specified managed policy. To update a managed policy, you create a new policy version. A managed policy can have up to five versions. If the policy has five versions, you must delete an existing version using DeletePolicyVersion before you create a new version.

Optionally, you can set the new version as the policy's default version. The default version is the operative version; that is, the version that is in effect for the IAM users, groups, and roles that the policy is attached to.

For more information about managed policy versions, see Versioning for Managed Policies in the Using IAM guide.

See: AWS API Reference for CreatePolicyVersion.

Creating a Request

createPolicyVersion

Arguments

:: Text

cpvPolicyARN

-> Text

cpvPolicyDocument

-> CreatePolicyVersion

Creates a value of CreatePolicyVersion with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cpvSetAsDefault
• cpvPolicyARN
• cpvPolicyDocument

data CreatePolicyVersion

See: createPolicyVersion smart constructor.

Instances

Eq CreatePolicyVersion

Data CreatePolicyVersion

Read CreatePolicyVersion

Show CreatePolicyVersion

Generic CreatePolicyVersion

AWSRequest CreatePolicyVersion

ToPath CreatePolicyVersion

ToHeaders CreatePolicyVersion

ToQuery CreatePolicyVersion

Typeable * CreatePolicyVersion

type Rep CreatePolicyVersion

type Rs CreatePolicyVersion = CreatePolicyVersionResponse

Request Lenses

cpvSetAsDefault :: Lens' CreatePolicyVersion (Maybe Bool)

Specifies whether to set this version as the policy's default version.

When this parameter is true, the new policy version becomes the operative version; that is, the version that is in effect for the IAM users, groups, and roles that the policy is attached to.

For more information about managed policy versions, see Versioning for Managed Policies in the Using IAM guide.

cpvPolicyARN :: Lens' CreatePolicyVersion Text

Undocumented member.

cpvPolicyDocument :: Lens' CreatePolicyVersion Text

The policy document.

Destructuring the Response

createPolicyVersionResponse

Arguments

:: Int

cpvrsStatus

-> CreatePolicyVersionResponse

Creates a value of CreatePolicyVersionResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cpvrsPolicyVersion
• cpvrsStatus

data CreatePolicyVersionResponse

Contains the response to a successful CreatePolicyVersion request.

See: createPolicyVersionResponse smart constructor.

Instances

Eq CreatePolicyVersionResponse

Data CreatePolicyVersionResponse

Read CreatePolicyVersionResponse

Show CreatePolicyVersionResponse

Generic CreatePolicyVersionResponse

Typeable * CreatePolicyVersionResponse

type Rep CreatePolicyVersionResponse

Response Lenses

cpvrsPolicyVersion :: Lens' CreatePolicyVersionResponse (Maybe PolicyVersion)

Information about the policy version.

cpvrsStatus :: Lens' CreatePolicyVersionResponse Int

The response status code.