DataZone / Client / create_project

create_project¶

DataZone.Client.create_project(**kwargs)¶

Creates an Amazon DataZone project.

Request Syntax

response = client.create_project(
    domainIdentifier='string',
    name='string',
    description='string',
    resourceTags={
        'string': 'string'
    },
    glossaryTerms=[
        'string',
    ],
    domainUnitId='string',
    projectProfileId='string',
    userParameters=[
        {
            'environmentId': 'string',
            'environmentResolvedAccount': {
                'awsAccountId': 'string',
                'regionName': 'string',
                'sourceAccountPoolId': 'string'
            },
            'environmentConfigurationName': 'string',
            'environmentParameters': [
                {
                    'name': 'string',
                    'value': 'string'
                },
            ]
        },
    ],
    projectCategory='string',
    projectExecutionRole='string',
    membershipAssignments=[
        {
            'member': {
                'userIdentifier': 'string',
                'groupIdentifier': 'string'
            },
            'designation': 'PROJECT_OWNER'|'PROJECT_CONTRIBUTOR'|'PROJECT_CATALOG_VIEWER'|'PROJECT_CATALOG_CONSUMER'|'PROJECT_CATALOG_STEWARD'
        },
    ]
)

Parameters:

domainIdentifier (string) –
[REQUIRED]

The ID of the Amazon DataZone domain in which this project is created.
name (string) –
[REQUIRED]

The name of the Amazon DataZone project.
description (string) – The description of the Amazon DataZone project.
resourceTags (dict) –
The resource tags of the project.
- (string) –
  - (string) –
glossaryTerms (list) –
The glossary terms that can be used in this Amazon DataZone project.
- (string) –
domainUnitId (string) – The ID of the domain unit. This parameter is not required and if it is not specified, then the project is created at the root domain unit level.
projectProfileId (string) – The ID of the project profile.
userParameters (list) –
The user parameters of the project.
- (dict) –
  
  The environment configuration user parameters.
  - environmentId (string) –
    
    The ID of the environment.
  - environmentResolvedAccount (dict) –
    
    Specifies the account/Region that is to be used during project creation for a particular blueprint.
    - awsAccountId (string) – [REQUIRED]
      
      The ID of the resolved account.
    - regionName (string) – [REQUIRED]
      
      The name of the resolved Region.
    - sourceAccountPoolId (string) –
      
      The ID of the account pool.
  - environmentConfigurationName (string) –
    
    The environment configuration name.
  - environmentParameters (list) –
    
    The environment parameters.
    - (dict) –
      
      The parameter details of an evironment profile.
      - name (string) –
        
        The name of an environment profile parameter.
      - value (string) –
        
        The value of an environment profile parameter.
projectCategory (string) – The category of the project. Set to ‘ADMIN’ designates this as an administrative project for the Amazon DataZone domain.
projectExecutionRole (string) – The default project IAM role that is used to access project resources and run computes such as Glue and Sagemaker.
membershipAssignments (list) –
The members to be assigned to the project.
- (dict) –
  
  A map of user or group profiles to designations that need to be assigned in the project.
  - member (dict) – [REQUIRED]
    
    The details about a project member.
    
    Note
    This is a Tagged Union structure. Only one of the following top level keys can be set: userIdentifier, groupIdentifier.
    - userIdentifier (string) –
      
      The user ID of a project member.
    - groupIdentifier (string) –
      
      The ID of the group of a project member.
  - designation (string) – [REQUIRED]
    
    The designation of the project membership.

Return type:

dict

Returns:

Response Syntax

{
    'domainId': 'string',
    'id': 'string',
    'name': 'string',
    'description': 'string',
    'projectStatus': 'ACTIVE'|'DELETING'|'DELETE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'MOVING',
    'failureReasons': [
        {
            'code': 'string',
            'message': 'string'
        },
    ],
    'createdBy': 'string',
    'createdAt': datetime(2015, 1, 1),
    'lastUpdatedAt': datetime(2015, 1, 1),
    'resourceTags': [
        {
            'key': 'string',
            'value': 'string',
            'source': 'PROJECT'|'PROJECT_PROFILE'
        },
    ],
    'glossaryTerms': [
        'string',
    ],
    'domainUnitId': 'string',
    'projectProfileId': 'string',
    'userParameters': [
        {
            'environmentId': 'string',
            'environmentResolvedAccount': {
                'awsAccountId': 'string',
                'regionName': 'string',
                'sourceAccountPoolId': 'string'
            },
            'environmentConfigurationName': 'string',
            'environmentParameters': [
                {
                    'name': 'string',
                    'value': 'string'
                },
            ]
        },
    ],
    'environmentDeploymentDetails': {
        'overallDeploymentStatus': 'PENDING_DEPLOYMENT'|'IN_PROGRESS'|'SUCCESSFUL'|'FAILED_VALIDATION'|'FAILED_DEPLOYMENT',
        'environmentFailureReasons': {
            'string': [
                {
                    'code': 'string',
                    'message': 'string'
                },
            ]
        }
    },
    'projectCategory': 'string'
}

Response Structure

(dict) –
- domainId (string) –
  
  The identifier of the Amazon DataZone domain in which the project was created.
- id (string) –
  
  The ID of the Amazon DataZone project.
- name (string) –
  
  The name of the project.
- description (string) –
  
  The description of the project.
- projectStatus (string) –
  
  The status of the Amazon DataZone project that was created.
- 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.
- createdBy (string) –
  
  The Amazon DataZone user who created the project.
- createdAt (datetime) –
  
  The timestamp of when the project was created.
- lastUpdatedAt (datetime) –
  
  The timestamp of when the project was last updated.
- resourceTags (list) –
  
  The resource tags of the project.
  - (dict) –
    
    The resource tag of the project.
    - key (string) –
      
      The key of the resource tag of the project.
    - value (string) –
      
      The value of the resource tag of the project.
    - source (string) –
      
      The source of the resource tag of the project.
- glossaryTerms (list) –
  
  The glossary terms that can be used in the project.
  - (string) –
- domainUnitId (string) –
  
  The ID of the domain unit.
- projectProfileId (string) –
  
  The project profile ID.
- userParameters (list) –
  
  The user parameters of the project.
  - (dict) –
    
    The environment configuration user parameters.
    - environmentId (string) –
      
      The ID of the environment.
    - environmentResolvedAccount (dict) –
      
      Specifies the account/Region that is to be used during project creation for a particular blueprint.
      - awsAccountId (string) –
        
        The ID of the resolved account.
      - regionName (string) –
        
        The name of the resolved Region.
      - sourceAccountPoolId (string) –
        
        The ID of the account pool.
    - environmentConfigurationName (string) –
      
      The environment configuration name.
    - environmentParameters (list) –
      
      The environment parameters.
      - (dict) –
        
        The parameter details of an evironment profile.
        
        name (string) –
        
        The name of an environment profile parameter.
        
        value (string) –
        
        The value of an environment profile parameter.
- environmentDeploymentDetails (dict) –
  
  The environment deployment details.
  - overallDeploymentStatus (string) –
    
    The overall deployment status of the environment.
  - environmentFailureReasons (dict) –
    
    Environment failure reasons.
    - (string) –
      - (list) –
        
        (dict) –
        
        The failure reasons for the environment deployment.
        
        code (string) –
        
        The error code for the failure reason for the environment deployment.
        
        message (string) –
        
        The error message for the failure reason for the environment deployment.
- projectCategory (string) –
  
  The category of the project.

Exceptions

DataZone.Client.exceptions.InternalServerException
DataZone.Client.exceptions.ResourceNotFoundException
DataZone.Client.exceptions.AccessDeniedException
DataZone.Client.exceptions.ThrottlingException
DataZone.Client.exceptions.ServiceQuotaExceededException
DataZone.Client.exceptions.ConflictException
DataZone.Client.exceptions.ValidationException
DataZone.Client.exceptions.UnauthorizedException