:doc:`CloudDirectory <../../clouddirectory>` / Client / upgrade_applied_schema

**********************
upgrade_applied_schema
**********************



.. py:method:: CloudDirectory.Client.upgrade_applied_schema(**kwargs)

  

  Upgrades a single directory in-place using the ``PublishedSchemaArn`` with schema updates found in ``MinorVersion``. Backwards-compatible minor version upgrades are instantaneously available for readers on all objects in the directory. Note: This is a synchronous API call and upgrades only one schema on a given directory per call. To upgrade multiple directories from one schema, you would need to call this API on each directory.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/clouddirectory-2017-01-11/UpgradeAppliedSchema>`_  


  **Request Syntax**
  ::

    response = client.upgrade_applied_schema(
        PublishedSchemaArn='string',
        DirectoryArn='string',
        DryRun=True|False
    )
    
  :type PublishedSchemaArn: string
  :param PublishedSchemaArn: **[REQUIRED]** 

    The revision of the published schema to upgrade the directory to.

    

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

    The ARN for the directory to which the upgraded schema will be applied.

    

  
  :type DryRun: boolean
  :param DryRun: 

    Used for testing whether the major version schemas are backward compatible or not. If schema compatibility fails, an exception would be thrown else the call would succeed but no changes will be saved. This parameter is optional.

    

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

    
    ::

      {
          'UpgradedSchemaArn': 'string',
          'DirectoryArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **UpgradedSchemaArn** *(string) --* 

        The ARN of the upgraded schema that is returned as part of the response.

        
      

      - **DirectoryArn** *(string) --* 

        The ARN of the directory that is returned as part of the response.

        
  
  **Exceptions**
  
  *   :py:class:`CloudDirectory.Client.exceptions.InternalServiceException`

  
  *   :py:class:`CloudDirectory.Client.exceptions.InvalidArnException`

  
  *   :py:class:`CloudDirectory.Client.exceptions.RetryableConflictException`

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

  
  *   :py:class:`CloudDirectory.Client.exceptions.IncompatibleSchemaException`

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

  
  *   :py:class:`CloudDirectory.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`CloudDirectory.Client.exceptions.InvalidAttachmentException`

  
  *   :py:class:`CloudDirectory.Client.exceptions.SchemaAlreadyExistsException`

  