:doc:`IoTTwinMaker <../../iottwinmaker>` / Client / create_scene

************
create_scene
************



.. py:method:: IoTTwinMaker.Client.create_scene(**kwargs)

  

  Creates a scene.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iottwinmaker-2021-11-29/CreateScene>`_  


  **Request Syntax**
  ::

    response = client.create_scene(
        workspaceId='string',
        sceneId='string',
        contentLocation='string',
        description='string',
        capabilities=[
            'string',
        ],
        tags={
            'string': 'string'
        },
        sceneMetadata={
            'string': 'string'
        }
    )
    
  :type workspaceId: string
  :param workspaceId: **[REQUIRED]** 

    The ID of the workspace that contains the scene.

    

  
  :type sceneId: string
  :param sceneId: **[REQUIRED]** 

    The ID of the scene.

    

  
  :type contentLocation: string
  :param contentLocation: **[REQUIRED]** 

    The relative path that specifies the location of the content definition file.

    

  
  :type description: string
  :param description: 

    The description for this scene.

    

  
  :type capabilities: list
  :param capabilities: 

    A list of capabilities that the scene uses to render itself.

    

  
    - *(string) --* 

    

  :type tags: dict
  :param tags: 

    Metadata that you can use to manage the scene.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  :type sceneMetadata: dict
  :param sceneMetadata: 

    The request metadata.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'arn': 'string',
          'creationDateTime': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **arn** *(string) --* 

        The ARN of the scene.

        
      

      - **creationDateTime** *(datetime) --* 

        The date and time when the scene was created.

        
  
  **Exceptions**
  
  *   :py:class:`IoTTwinMaker.Client.exceptions.InternalServerException`

  
  *   :py:class:`IoTTwinMaker.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`IoTTwinMaker.Client.exceptions.ThrottlingException`

  
  *   :py:class:`IoTTwinMaker.Client.exceptions.ValidationException`

  
  *   :py:class:`IoTTwinMaker.Client.exceptions.ConflictException`

  
  *   :py:class:`IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException`

  