MultipartyApproval / Client / list_policy_versions

list_policy_versions

MultipartyApproval.Client.list_policy_versions(**kwargs)

Returns a list of the versions for policies. Policies define the permissions for team resources.

The protected operation for a service integration might require specific permissions. For more information, see How other services work with Multi-party approval in the Multi-party approval User Guide.

See also: AWS API Documentation

Request Syntax

response = client.list_policy_versions(
    MaxResults=123,
    NextToken='string',
    PolicyArn='string'
)
Parameters:

  • MaxResults (integer) – The maximum number of items to return in the response. If more results exist than the specified MaxResults value, a token is included in the response so that you can retrieve the remaining results.

  • NextToken (string) – If present, indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a next call to the operation to get more output. You can repeat this until the NextToken response element returns null.

  • PolicyArn (string) –

    [REQUIRED]

    Amazon Resource Name (ARN) for the policy.

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'PolicyVersions': [
        {
            'Arn': 'string',
            'PolicyArn': 'string',
            'VersionId': 123,
            'PolicyType': 'AWS_MANAGED'|'AWS_RAM',
            'IsDefault': True|False,
            'Name': 'string',
            'Status': 'ATTACHABLE'|'DEPRECATED',
            'CreationTime': datetime(2015, 1, 1),
            'LastUpdatedTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) –

    • NextToken (string) –

      If present, indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a next call to the operation to get more output. You can repeat this until the NextToken response element returns null.

    • PolicyVersions (list) –

      An array of PolicyVersionSummary objects. Contains details for the version of the policies that define the permissions for team resources.

      The protected operation for a service integration might require specific permissions. For more information, see How other services work with Multi-party approval in the Multi-party approval User Guide.

      • (dict) –

        Contains details for the version of a policy. Policies define what operations a team that define the permissions for team resources.

        The protected operation for a service integration might require specific permissions. For more information, see How other services work with Multi-party approval in the Multi-party approval User Guide.

        • Arn (string) –

          Amazon Resource Name (ARN) for the team.

        • PolicyArn (string) –

          Amazon Resource Name (ARN) for the policy.

        • VersionId (integer) –

          Version ID for the policy.

        • PolicyType (string) –

          The type of policy.

        • IsDefault (boolean) –

          Determines if the specified policy is the default for the team.

        • Name (string) –

          Name of the policy

        • Status (string) –

          Status for the policy. For example, if the policy is attachable or deprecated.

        • CreationTime (datetime) –

          Timestamp when the policy was created.

        • LastUpdatedTime (datetime) –

          Timestamp when the policy was last updated.

Exceptions