:doc:`odb <../../odb>` / Client / get_db_server

*************
get_db_server
*************



.. py:method:: odb.Client.get_db_server(**kwargs)

  

  Returns information about the specified database server.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/odb-2024-08-20/GetDbServer>`_  


  **Request Syntax**
  ::

    response = client.get_db_server(
        cloudExadataInfrastructureId='string',
        dbServerId='string'
    )
    
  :type cloudExadataInfrastructureId: string
  :param cloudExadataInfrastructureId: **[REQUIRED]** 

    The unique identifier of the Oracle Exadata infrastructure that contains the database server.

    

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

    The unique identifier of the database server to retrieve information about.

    

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

    
    ::

      {
          'dbServer': {
              'dbServerId': 'string',
              'status': 'AVAILABLE'|'FAILED'|'PROVISIONING'|'TERMINATED'|'TERMINATING'|'UPDATING'|'MAINTENANCE_IN_PROGRESS',
              'statusReason': 'string',
              'cpuCoreCount': 123,
              'dbNodeStorageSizeInGBs': 123,
              'dbServerPatchingDetails': {
                  'estimatedPatchDuration': 123,
                  'patchingStatus': 'COMPLETE'|'FAILED'|'MAINTENANCE_IN_PROGRESS'|'SCHEDULED',
                  'timePatchingEnded': 'string',
                  'timePatchingStarted': 'string'
              },
              'displayName': 'string',
              'exadataInfrastructureId': 'string',
              'ocid': 'string',
              'ociResourceAnchorName': 'string',
              'maxCpuCount': 123,
              'maxDbNodeStorageInGBs': 123,
              'maxMemoryInGBs': 123,
              'memorySizeInGBs': 123,
              'shape': 'string',
              'createdAt': datetime(2015, 1, 1),
              'vmClusterIds': [
                  'string',
              ],
              'computeModel': 'ECPU'|'OCPU',
              'autonomousVmClusterIds': [
                  'string',
              ],
              'autonomousVirtualMachineIds': [
                  'string',
              ]
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **dbServer** *(dict) --* 

        The details of the requested database server.

        
        

        - **dbServerId** *(string) --* 

          The unique identifier for the database server.

          
        

        - **status** *(string) --* 

          The current status of the database server.

          
        

        - **statusReason** *(string) --* 

          Additional information about the current status of the database server.

          
        

        - **cpuCoreCount** *(integer) --* 

          The number of CPU cores enabled on the database server.

          
        

        - **dbNodeStorageSizeInGBs** *(integer) --* 

          The allocated local node storage in GBs on the database server.

          
        

        - **dbServerPatchingDetails** *(dict) --* 

          The scheduling details for the quarterly maintenance window. Patching and system updates take place during the maintenance window.

          
          

          - **estimatedPatchDuration** *(integer) --* 

            Estimated time, in minutes, to patch one database server.

            
          

          - **patchingStatus** *(string) --* 

            The status of the patching operation. Possible values are ``SCHEDULED``, ``MAINTENANCE_IN_PROGRESS``, ``FAILED``, and ``COMPLETE``.

            
          

          - **timePatchingEnded** *(string) --* 

            The time when the patching operation ended.

            
          

          - **timePatchingStarted** *(string) --* 

            The time when the patching operation started.

            
      
        

        - **displayName** *(string) --* 

          The user-friendly name of the database server.

          
        

        - **exadataInfrastructureId** *(string) --* 

          The ID of the Exadata infrastructure the database server belongs to.

          
        

        - **ocid** *(string) --* 

          The OCID of the database server.

          
        

        - **ociResourceAnchorName** *(string) --* 

          The name of the OCI resource anchor for the database server.

          
        

        - **maxCpuCount** *(integer) --* 

          The total number of CPU cores available.

          
        

        - **maxDbNodeStorageInGBs** *(integer) --* 

          The total local node storage available in GBs.

          
        

        - **maxMemoryInGBs** *(integer) --* 

          The total memory available in GBs.

          
        

        - **memorySizeInGBs** *(integer) --* 

          The allocated memory in GBs on the database server.

          
        

        - **shape** *(string) --* 

          The shape of the database server. The shape determines the amount of CPU, storage, and memory resources available.

          
        

        - **createdAt** *(datetime) --* 

          The date and time when the database server was created.

          
        

        - **vmClusterIds** *(list) --* 

          The OCID of the VM clusters that are associated with the database server.

          
          

          - *(string) --* 
      
        

        - **computeModel** *(string) --* 

          The compute model of the database server (ECPU or OCPU).

          
        

        - **autonomousVmClusterIds** *(list) --* 

          The list of identifiers for the Autonomous VM clusters associated with this database server.

          
          

          - *(string) --* 
      
        

        - **autonomousVirtualMachineIds** *(list) --* 

          The list of unique identifiers for the Autonomous VMs associated with this database server.

          
          

          - *(string) --* 
      
    
  
  **Exceptions**
  
  *   :py:class:`odb.Client.exceptions.ThrottlingException`

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

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

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

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

  