Skip to content

IAM  >  Structures  >  PolicyVersion

PolicyVersion

Structure Class

PolicyVersion dataclass

Bases: _SerdeShape

Contains information about a version of a managed policy.

This data type is used as a response element in the CreatePolicyVersion, GetPolicyVersion, ListPolicyVersions, and GetAccountAuthorizationDetails operations.

For more information about managed policies, refer to Managed policies and inline policies in the IAM User Guide.

Attributes

create_date class-attribute instance-attribute
create_date: datetime | None = ...

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

document class-attribute instance-attribute
document: str | None = ...

The policy document.

The policy document is returned in the response to the GetPolicyVersion and GetAccountAuthorizationDetails operations. It is not returned in the response to the CreatePolicyVersion or ListPolicyVersions operations.

The policy document returned in this structure is URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

is_default_version class-attribute instance-attribute
is_default_version: bool = ...

Specifies whether the policy version is set as the policy's default version.

version_id class-attribute instance-attribute
version_id: str | None = ...

The identifier for the policy version.

Policy version identifiers always begin with v (always lowercase). When a policy is created, the first policy version is v1.