:doc:`LicenseManagerUserSubscriptions <../../license-manager-user-subscriptions>` / Client / update_identity_provider_settings

*********************************
update_identity_provider_settings
*********************************



.. py:method:: LicenseManagerUserSubscriptions.Client.update_identity_provider_settings(**kwargs)

  

  Updates additional product configuration settings for the registered identity provider.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/license-manager-user-subscriptions-2018-05-10/UpdateIdentityProviderSettings>`_  


  **Request Syntax**
  ::

    response = client.update_identity_provider_settings(
        IdentityProvider={
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string',
                'ActiveDirectorySettings': {
                    'DomainName': 'string',
                    'DomainIpv4List': [
                        'string',
                    ],
                    'DomainIpv6List': [
                        'string',
                    ],
                    'DomainCredentialsProvider': {
                        'SecretsManagerCredentialsProvider': {
                            'SecretId': 'string'
                        }
                    },
                    'DomainNetworkSettings': {
                        'Subnets': [
                            'string',
                        ]
                    }
                },
                'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
                'IsSharedActiveDirectory': True|False
            }
        },
        Product='string',
        IdentityProviderArn='string',
        UpdateSettings={
            'AddSubnets': [
                'string',
            ],
            'RemoveSubnets': [
                'string',
            ],
            'SecurityGroupId': 'string'
        }
    )
    
  :type IdentityProvider: dict
  :param IdentityProvider: 

    Refers to an identity provider.

    .. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: ``ActiveDirectoryIdentityProvider``. 

  
    - **ActiveDirectoryIdentityProvider** *(dict) --* 

      The ``ActiveDirectoryIdentityProvider`` resource contains settings and other details about a specific Active Directory identity provider.

      

    
      - **DirectoryId** *(string) --* 

        The directory ID for an Active Directory identity provider.

        

      
      - **ActiveDirectorySettings** *(dict) --* 

        The ``ActiveDirectorySettings`` resource contains details about the Active Directory, including network access details such as domain name and IP addresses, and the credential provider for user administration.

        

      
        - **DomainName** *(string) --* 

          The domain name for the Active Directory.

          

        
        - **DomainIpv4List** *(list) --* 

          A list of domain IPv4 addresses that are used for the Active Directory.

          

        
          - *(string) --* 

          
      
        - **DomainIpv6List** *(list) --* 

          A list of domain IPv6 addresses that are used for the Active Directory.

          

        
          - *(string) --* 

          
      
        - **DomainCredentialsProvider** *(dict) --* 

          Points to the ``CredentialsProvider`` resource that contains information about the credential provider for user administration.

          .. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: ``SecretsManagerCredentialsProvider``. 

        
          - **SecretsManagerCredentialsProvider** *(dict) --* 

            Identifies the Secrets Manager secret that contains credentials needed for user administration in the Active Directory.

            

          
            - **SecretId** *(string) --* 

              The ID of the Secrets Manager secret that contains credentials.

              

            
          
        
        - **DomainNetworkSettings** *(dict) --* 

          The ``DomainNetworkSettings`` resource contains an array of subnets that apply for the Active Directory.

          

        
          - **Subnets** *(list) --* **[REQUIRED]** 

            Contains a list of subnets that apply for the Active Directory domain.

            

          
            - *(string) --* 

            
        
        
      
      - **ActiveDirectoryType** *(string) --* 

        The type of Active Directory – either a self-managed Active Directory or an Amazon Web Services Managed Active Directory.

        

      
      - **IsSharedActiveDirectory** *(boolean) --* 

        Whether this directory is shared from an Amazon Web Services Managed Active Directory. The default value is false.

        

      
    
  
  :type Product: string
  :param Product: 

    The name of the user-based subscription product.

     

    Valid values: ``VISUAL_STUDIO_ENTERPRISE`` | ``VISUAL_STUDIO_PROFESSIONAL`` | ``OFFICE_PROFESSIONAL_PLUS`` | ``REMOTE_DESKTOP_SERVICES``

    

  
  :type IdentityProviderArn: string
  :param IdentityProviderArn: 

    The Amazon Resource Name (ARN) of the identity provider to update.

    

  
  :type UpdateSettings: dict
  :param UpdateSettings: **[REQUIRED]** 

    Updates the registered identity provider’s product related configuration settings. You can update any combination of settings in a single operation such as the:

     

    
    * Subnets which you want to add to provision VPC endpoints.
     
    * Subnets which you want to remove the VPC endpoints from.
     
    * Security group ID which permits traffic to the VPC endpoints.
    

    

  
    - **AddSubnets** *(list) --* **[REQUIRED]** 

      The ID of one or more subnets in which License Manager will create a VPC endpoint for products that require connectivity to activation servers.

      

    
      - *(string) --* 

      
  
    - **RemoveSubnets** *(list) --* **[REQUIRED]** 

      The ID of one or more subnets to remove.

      

    
      - *(string) --* 

      
  
    - **SecurityGroupId** *(string) --* 

      A security group ID that allows inbound TCP port 1688 communication between resources in your VPC and the VPC endpoints for activation servers.

      

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

    
    ::

      {
          'IdentityProviderSummary': {
              'IdentityProvider': {
                  'ActiveDirectoryIdentityProvider': {
                      'DirectoryId': 'string',
                      'ActiveDirectorySettings': {
                          'DomainName': 'string',
                          'DomainIpv4List': [
                              'string',
                          ],
                          'DomainIpv6List': [
                              'string',
                          ],
                          'DomainCredentialsProvider': {
                              'SecretsManagerCredentialsProvider': {
                                  'SecretId': 'string'
                              }
                          },
                          'DomainNetworkSettings': {
                              'Subnets': [
                                  'string',
                              ]
                          }
                      },
                      'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
                      'IsSharedActiveDirectory': True|False
                  }
              },
              'Settings': {
                  'Subnets': [
                      'string',
                  ],
                  'SecurityGroupId': 'string'
              },
              'Product': 'string',
              'Status': 'string',
              'IdentityProviderArn': 'string',
              'FailureMessage': 'string',
              'OwnerAccountId': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **IdentityProviderSummary** *(dict) --* 

        Describes an identity provider.

        
        

        - **IdentityProvider** *(dict) --* 

          The ``IdentityProvider`` resource contains information about an identity provider.

          .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: ``ActiveDirectoryIdentityProvider``.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows::

                    'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}


        
          

          - **ActiveDirectoryIdentityProvider** *(dict) --* 

            The ``ActiveDirectoryIdentityProvider`` resource contains settings and other details about a specific Active Directory identity provider.

            
            

            - **DirectoryId** *(string) --* 

              The directory ID for an Active Directory identity provider.

              
            

            - **ActiveDirectorySettings** *(dict) --* 

              The ``ActiveDirectorySettings`` resource contains details about the Active Directory, including network access details such as domain name and IP addresses, and the credential provider for user administration.

              
              

              - **DomainName** *(string) --* 

                The domain name for the Active Directory.

                
              

              - **DomainIpv4List** *(list) --* 

                A list of domain IPv4 addresses that are used for the Active Directory.

                
                

                - *(string) --* 
            
              

              - **DomainIpv6List** *(list) --* 

                A list of domain IPv6 addresses that are used for the Active Directory.

                
                

                - *(string) --* 
            
              

              - **DomainCredentialsProvider** *(dict) --* 

                Points to the ``CredentialsProvider`` resource that contains information about the credential provider for user administration.

                .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: ``SecretsManagerCredentialsProvider``.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows::

                                'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}


              
                

                - **SecretsManagerCredentialsProvider** *(dict) --* 

                  Identifies the Secrets Manager secret that contains credentials needed for user administration in the Active Directory.

                  
                  

                  - **SecretId** *(string) --* 

                    The ID of the Secrets Manager secret that contains credentials.

                    
              
            
              

              - **DomainNetworkSettings** *(dict) --* 

                The ``DomainNetworkSettings`` resource contains an array of subnets that apply for the Active Directory.

                
                

                - **Subnets** *(list) --* 

                  Contains a list of subnets that apply for the Active Directory domain.

                  
                  

                  - *(string) --* 
              
            
          
            

            - **ActiveDirectoryType** *(string) --* 

              The type of Active Directory – either a self-managed Active Directory or an Amazon Web Services Managed Active Directory.

              
            

            - **IsSharedActiveDirectory** *(boolean) --* 

              Whether this directory is shared from an Amazon Web Services Managed Active Directory. The default value is false.

              
        
      
        

        - **Settings** *(dict) --* 

          The ``Settings`` resource contains details about the registered identity provider’s product related configuration settings, such as the subnets to provision VPC endpoints.

          
          

          - **Subnets** *(list) --* 

            The subnets defined for the registered identity provider.

            
            

            - *(string) --* 
        
          

          - **SecurityGroupId** *(string) --* 

            A security group ID that allows inbound TCP port 1688 communication between resources in your VPC and the VPC endpoint for activation servers.

            
      
        

        - **Product** *(string) --* 

          The name of the user-based subscription product.

          
        

        - **Status** *(string) --* 

          The status of the identity provider.

          
        

        - **IdentityProviderArn** *(string) --* 

          The Amazon Resource Name (ARN) of the identity provider.

          
        

        - **FailureMessage** *(string) --* 

          The failure message associated with an identity provider.

          
        

        - **OwnerAccountId** *(string) --* 

          The AWS Account ID of the owner of this resource.

          
    
  
  **Exceptions**
  
  *   :py:class:`LicenseManagerUserSubscriptions.Client.exceptions.ValidationException`

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

  
  *   :py:class:`LicenseManagerUserSubscriptions.Client.exceptions.InternalServerException`

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

  