describe_acls

describe_acls(**kwargs)

Returns a list of ACLs

See also: AWS API Documentation

Request Syntax

response = client.describe_acls(
    ACLName='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • ACLName (string) -- The name of the ACL
  • MaxResults (integer) -- The maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
  • NextToken (string) -- An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
Return type

dict

Returns

Response Syntax

{
    'ACLs': [
        {
            'Name': 'string',
            'Status': 'string',
            'UserNames': [
                'string',
            ],
            'MinimumEngineVersion': 'string',
            'PendingChanges': {
                'UserNamesToRemove': [
                    'string',
                ],
                'UserNamesToAdd': [
                    'string',
                ]
            },
            'Clusters': [
                'string',
            ],
            'ARN': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • ACLs (list) --

      The list of ACLs

      • (dict) --

        An Access Control List. You can authenticate users with Access Contol Lists. ACLs enable you to control cluster access by grouping users. These Access control lists are designed as a way to organize access to clusters.

        • Name (string) --

          The name of the Access Control List

        • Status (string) --

          Indicates ACL status. Can be "creating", "active", "modifying", "deleting".

        • UserNames (list) --

          The list of user names that belong to the ACL.

          • (string) --
        • MinimumEngineVersion (string) --

          The minimum engine version supported for the ACL

        • PendingChanges (dict) --

          A list of updates being applied to the ACL.

          • UserNamesToRemove (list) --

            A list of user names being removed from the ACL

            • (string) --
          • UserNamesToAdd (list) --

            A list of users being added to the ACL

            • (string) --
        • Clusters (list) --

          A list of clusters associated with the ACL.

          • (string) --
        • ARN (string) --

          The Amazon Resource Name (ARN) of the ACL

    • NextToken (string) --

      If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.

Exceptions

  • MemoryDB.Client.exceptions.ACLNotFoundFault
  • MemoryDB.Client.exceptions.InvalidParameterCombinationException