AWSDeadlineCloud

Lists the Deadline Cloud resource memberships associated with a specified IAM Identity Center principal, optionally filtered by the requested resource types.

See also: AWS API Documentation

Request Syntax

client.list_memberships(
    nextToken='string',
    maxResults=123,
    principalId='string',
    identityStoreId='string',
    identityCenterRegion='string',
    resourceTypes=[
        'FARM'|'QUEUE'|'FLEET'|'JOB',
    ]
)

type nextToken:

string

param nextToken:

The token for the next set of results, or null to start from the beginning.

type maxResults:

integer

param maxResults:

The maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

type principalId:

string

param principalId:

[REQUIRED]

The ID of the IAM Identity Center principal whose Deadline Cloud resource memberships you want to list.

type identityStoreId:

string

param identityStoreId:

The identity store ID that contains the principal. This parameter is required for callers that do not use a monitor session.

type identityCenterRegion:

string

param identityCenterRegion:

The Region of the IAM Identity Center instance. If not provided, the service defaults to the Amazon Web Services Region in which you make the request.

type resourceTypes:

list

param resourceTypes:

The resource types to include when listing the principal's memberships. If not specified, memberships for all supported resource types are returned.

• (string) --

rtype:

dict

returns:

Response Syntax

{
    'memberships': [
        {
            'farm': {
                'farmId': 'string',
                'principalId': 'string',
                'principalType': 'USER'|'GROUP',
                'identityStoreId': 'string',
                'membershipLevel': 'VIEWER'|'CONTRIBUTOR'|'OWNER'|'MANAGER'
            },
            'queue': {
                'farmId': 'string',
                'queueId': 'string',
                'principalId': 'string',
                'principalType': 'USER'|'GROUP',
                'identityStoreId': 'string',
                'membershipLevel': 'VIEWER'|'CONTRIBUTOR'|'OWNER'|'MANAGER'
            },
            'fleet': {
                'farmId': 'string',
                'fleetId': 'string',
                'principalId': 'string',
                'principalType': 'USER'|'GROUP',
                'identityStoreId': 'string',
                'membershipLevel': 'VIEWER'|'CONTRIBUTOR'|'OWNER'|'MANAGER'
            },
            'job': {
                'farmId': 'string',
                'queueId': 'string',
                'jobId': 'string',
                'principalId': 'string',
                'principalType': 'USER'|'GROUP',
                'identityStoreId': 'string',
                'membershipLevel': 'VIEWER'|'CONTRIBUTOR'|'OWNER'|'MANAGER'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) --

  Shared pagination field for List operation outputs (nextToken).

  • memberships (list) --

    The memberships associated with the specified principal.

    • (dict) --

      A membership record for a principal on a single Deadline Cloud resource. The summary identifies the resource that the principal is a member of and the principal's membership level for that resource.

      • farm (dict) --

        A membership on a farm.

        • farmId (string) --

          The farm ID of the farm member.

        • principalId (string) --

          The principal ID of the farm member.

        • principalType (string) --

          The principal type of the farm member.

        • identityStoreId (string) --

          The identity store ID of the farm member.

        • membershipLevel (string) --

          The farm member's membership level.

      • queue (dict) --

        A membership on a queue.

        • farmId (string) --

          The farm ID.

        • queueId (string) --

          The queue ID.

        • principalId (string) --

          The principal ID of the queue member.

        • principalType (string) --

          The principal type of the queue member.

        • identityStoreId (string) --

          The identity store ID.

        • membershipLevel (string) --

          The queue member's membership level.

      • fleet (dict) --

        A membership on a fleet.

        • farmId (string) --

          The farm ID.

        • fleetId (string) --

          The fleet ID.

        • principalId (string) --

          The principal ID of the fleet member.

        • principalType (string) --

          The principal type of the fleet member.

        • identityStoreId (string) --

          The identity store ID.

        • membershipLevel (string) --

          The fleet member's membership level.

      • job (dict) --

        A membership on a job.

        • farmId (string) --

          The farm ID.

        • queueId (string) --

          The queue ID.

        • jobId (string) --

          The job ID.

        • principalId (string) --

          The principal ID of the job member.

        • principalType (string) --

          The principal type of the job member.

        • identityStoreId (string) --

          The identity store ID.

        • membershipLevel (string) --

          The job member's membership level.

  • nextToken (string) --

    If Deadline Cloud returns nextToken, then there are more results available. The value of nextToken is a unique pagination token for each page. To retrieve the next page, call the operation again using the returned token. Keep all other arguments unchanged. If no results remain, then nextToken is set to null. Each pagination token expires after 24 hours. If you provide a token that isn't valid, then you receive an HTTP 400 ValidationException error.