DataZone / Client / list_projects

list_projects#

DataZone.Client.list_projects(**kwargs)#

Lists Amazon DataZone projects.

Request Syntax

response = client.list_projects(
    domainIdentifier='string',
    groupIdentifier='string',
    maxResults=123,
    name='string',
    nextToken='string',
    userIdentifier='string'
)

Parameters:

domainIdentifier (string) –
[REQUIRED]

The identifier of the Amazon DataZone domain.
groupIdentifier (string) – The identifier of a group.
maxResults (integer) – The maximum number of projects to return in a single call to ListProjects. When the number of projects to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListProjects to list the next set of projects.
name (string) – The name of the project.
nextToken (string) – When the number of projects is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of projects, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListProjects to list the next set of projects.
userIdentifier (string) – The identifier of the Amazon DataZone user.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'description': 'string',
            'domainId': 'string',
            'domainUnitId': 'string',
            'failureReasons': [
                {
                    'code': 'string',
                    'message': 'string'
                },
            ],
            'id': 'string',
            'name': 'string',
            'projectStatus': 'ACTIVE'|'DELETING'|'DELETE_FAILED',
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –
- items (list) –
  
  The results of the ListProjects action.
  - (dict) –
    
    The details of a Amazon DataZone project.
    - createdAt (datetime) –
      
      The timestamp of when a project was created.
    - createdBy (string) –
      
      The Amazon DataZone user who created the project.
    - description (string) –
      
      The description of a project.
    - domainId (string) –
      
      The identifier of a Amazon DataZone domain where the project exists.
    - domainUnitId (string) –
      
      The ID of the domain unit.
    - failureReasons (list) –
      
      Specifies the error message that is returned if the operation cannot be successfully completed.
      - (dict) –
        
        Specifies the error message that is returned if the operation cannot be successfully completed.
        
        code (string) –
        
        The code of the project deletion error.
        
        message (string) –
        
        The message of the project deletion error.
    - id (string) –
      
      The identifier of a project.
    - name (string) –
      
      The name of a project.
    - projectStatus (string) –
      
      The status of the project.
    - updatedAt (datetime) –
      
      The timestamp of when the project was updated.
- nextToken (string) –
  
  When the number of projects is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of projects, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListProjects to list the next set of projects.

Exceptions

DataZone.Client.exceptions.InternalServerException
DataZone.Client.exceptions.AccessDeniedException
DataZone.Client.exceptions.ThrottlingException
DataZone.Client.exceptions.ValidationException
DataZone.Client.exceptions.UnauthorizedException