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

*********************
list_db_system_shapes
*********************



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

  

  Returns information about the shapes that are available for an Exadata infrastructure.

  

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


  **Request Syntax**
  ::

    response = client.list_db_system_shapes(
        maxResults=123,
        nextToken='string',
        availabilityZone='string',
        availabilityZoneId='string'
    )
    
  :type maxResults: integer
  :param maxResults: 

    The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output.

     

    Default: ``10``

    

  
  :type nextToken: string
  :param nextToken: 

    The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

    

  
  :type availabilityZone: string
  :param availabilityZone: 

    The logical name of the AZ, for example, us-east-1a. This name varies depending on the account.

    

  
  :type availabilityZoneId: string
  :param availabilityZoneId: 

    The physical ID of the AZ, for example, use1-az4. This ID persists across accounts.

    

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

    
    ::

      {
          'nextToken': 'string',
          'dbSystemShapes': [
              {
                  'availableCoreCount': 123,
                  'availableCoreCountPerNode': 123,
                  'availableDataStorageInTBs': 123,
                  'availableDataStoragePerServerInTBs': 123,
                  'availableDbNodePerNodeInGBs': 123,
                  'availableDbNodeStorageInGBs': 123,
                  'availableMemoryInGBs': 123,
                  'availableMemoryPerNodeInGBs': 123,
                  'coreCountIncrement': 123,
                  'maxStorageCount': 123,
                  'maximumNodeCount': 123,
                  'minCoreCountPerNode': 123,
                  'minDataStorageInTBs': 123,
                  'minDbNodeStoragePerNodeInGBs': 123,
                  'minMemoryPerNodeInGBs': 123,
                  'minStorageCount': 123,
                  'minimumCoreCount': 123,
                  'minimumNodeCount': 123,
                  'runtimeMinimumCoreCount': 123,
                  'shapeFamily': 'string',
                  'shapeType': 'AMD'|'INTEL'|'INTEL_FLEX_X9'|'AMPERE_FLEX_A1',
                  'name': 'string',
                  'computeModel': 'ECPU'|'OCPU',
                  'areServerTypesSupported': True|False
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **nextToken** *(string) --* 

        The token to include in another request to get the next page of items. This value is ``null`` when there are no more items to return.

        
      

      - **dbSystemShapes** *(list) --* 

        The list of shapes and their properties.

        
        

        - *(dict) --* 

          Information about a hardware system model (shape) that's available for an Exadata infrastructure. The shape determines resources, such as CPU cores, memory, and storage, to allocate to the Exadata infrastructure.

          
          

          - **availableCoreCount** *(integer) --* 

            The maximum number of CPU cores that can be enabled for the shape.

            
          

          - **availableCoreCountPerNode** *(integer) --* 

            The maximum number of CPU cores per DB node that can be enabled for the shape.

            
          

          - **availableDataStorageInTBs** *(integer) --* 

            The maximum amount of data storage, in terabytes (TB), that can be enabled for the shape.

            
          

          - **availableDataStoragePerServerInTBs** *(integer) --* 

            The maximum amount of data storage, in terabytes (TB), that's available per storage server for the shape.

            
          

          - **availableDbNodePerNodeInGBs** *(integer) --* 

            The maximum amount of DB node storage, in gigabytes (GB), that's available per DB node for the shape.

            
          

          - **availableDbNodeStorageInGBs** *(integer) --* 

            The maximum amount of DB node storage, in gigabytes (GB), that can be enabled for the shape.

            
          

          - **availableMemoryInGBs** *(integer) --* 

            The maximum amount of memory, in gigabytes (GB), that can be enabled for the shape.

            
          

          - **availableMemoryPerNodeInGBs** *(integer) --* 

            The maximum amount of memory, in gigabytes (GB), that's available per DB node for the shape.

            
          

          - **coreCountIncrement** *(integer) --* 

            The discrete number by which the CPU core count for the shape can be increased or decreased.

            
          

          - **maxStorageCount** *(integer) --* 

            The maximum number of Exadata storage servers that's available for the shape.

            
          

          - **maximumNodeCount** *(integer) --* 

            The maximum number of compute servers that is available for the shape.

            
          

          - **minCoreCountPerNode** *(integer) --* 

            The minimum number of CPU cores that can be enabled per node for the shape.

            
          

          - **minDataStorageInTBs** *(integer) --* 

            The minimum amount of data storage, in terabytes (TB), that must be allocated for the shape.

            
          

          - **minDbNodeStoragePerNodeInGBs** *(integer) --* 

            The minimum amount of DB node storage, in gigabytes (GB), that must be allocated per DB node for the shape.

            
          

          - **minMemoryPerNodeInGBs** *(integer) --* 

            The minimum amount of memory, in gigabytes (GB), that must be allocated per DB node for the shape.

            
          

          - **minStorageCount** *(integer) --* 

            The minimum number of Exadata storage servers that are available for the shape.

            
          

          - **minimumCoreCount** *(integer) --* 

            The minimum number of CPU cores that can be enabled for the shape.

            
          

          - **minimumNodeCount** *(integer) --* 

            The minimum number of compute servers that are available for the shape.

            
          

          - **runtimeMinimumCoreCount** *(integer) --* 

            The runtime minimum number of CPU cores that can be enabled for the shape.

            
          

          - **shapeFamily** *(string) --* 

            The family of the shape.

            
          

          - **shapeType** *(string) --* 

            The shape type. This property is determined by the CPU hardware.

            
          

          - **name** *(string) --* 

            The name of the shape.

            
          

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

            The OCI model compute model used when you create or clone an instance: ECPU or OCPU. An ECPU is an abstracted measure of compute resources. ECPUs are based on the number of cores elastically allocated from a pool of compute and storage servers. An OCPU is a legacy physical measure of compute resources. OCPUs are based on the physical core of a processor with hyper-threading enabled.

            
          

          - **areServerTypesSupported** *(boolean) --* 

            Indicates whether the hardware system model supports configurable database and server storage types.

            
      
    
  
  **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`

  