:doc:`Cloud9 <../../cloud9>` / Client / update_environment

******************
update_environment
******************



.. py:method:: Cloud9.Client.update_environment(**kwargs)

  

  Changes the settings of an existing Cloud9 development environment.

   

  .. warning::

     

    Cloud9 is no longer available to new customers. Existing customers of Cloud9 can continue to use the service as normal. `Learn more" <http://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/>`__

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloud9-2017-09-23/UpdateEnvironment>`_  


  **Request Syntax**
  ::

    response = client.update_environment(
        environmentId='string',
        name='string',
        description='string',
        managedCredentialsAction='ENABLE'|'DISABLE'
    )
    
  :type environmentId: string
  :param environmentId: **[REQUIRED]** 

    The ID of the environment to change settings.

    

  
  :type name: string
  :param name: 

    A replacement name for the environment.

    

  
  :type description: string
  :param description: 

    Any new or replacement description for the environment.

    

  
  :type managedCredentialsAction: string
  :param managedCredentialsAction: 

    Allows the environment owner to turn on or turn off the Amazon Web Services managed temporary credentials for an Cloud9 environment by using one of the following values:

     

    
    * ``ENABLE``
     
    * ``DISABLE``
    

     

    .. note::

      

      Only the environment owner can change the status of managed temporary credentials. An ``AccessDeniedException`` is thrown if an attempt to turn on or turn off managed temporary credentials is made by an account that's not the environment owner.

      

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`Cloud9.Client.exceptions.BadRequestException`

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

  
  *   :py:class:`Cloud9.Client.exceptions.NotFoundException`

  
  *   :py:class:`Cloud9.Client.exceptions.ForbiddenException`

  
  *   :py:class:`Cloud9.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`Cloud9.Client.exceptions.LimitExceededException`

  
  *   :py:class:`Cloud9.Client.exceptions.InternalServerErrorException`

  

  **Examples**

  
  ::

    response = client.update_environment(
        name='my-changed-demo-environment',
        description='This is my changed demonstration environment.',
        environmentId='8d9967e2f0624182b74e7690ad69ebEX',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'ResponseMetadata': {
            '...': '...',
        },
    }

  