# Compute Engine API . machineTypes

## Instance Methods

Retrieves the list of machine type resources grouped by scope.

Retrieves the next page of results.

Returns the specified machine type resource.

Retrieves the list of machine type resources available to the specified project.

Retrieves the next page of results.

### Method Details

`aggregatedList(project, maxResults=None, pageToken=None, filter=None)`

    Retrieves the list of machine type resources grouped by scope.

    Args:
      project: string, Name of the project scoping this request. (required)
      maxResults: integer, Optional. Maximum count of results to be returned. Maximum and default value is 100.
      pageToken: string, Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.
      filter: string, Optional. Filter expression for filtering listed resources.

    Returns:
      An object of the form:

        {
        "nextPageToken": "A String", # A token used to continue a truncated list request (output only).
        "items": { # A map of scoped machine type lists.
          "a_key": { # Name of the scope containing this set of machine types.
            "machineTypes": [ # List of machine types contained in this scope.
              { # A machine type resource.
                "guestCpus": 42, # Count of CPUs exposed to the instance.
                "imageSpaceGb": 42, # Space allotted for the image, defined in GB.
                "kind": "compute#machineType", # Type of the resource.
                "maximumPersistentDisksSizeGb": "A String", # Maximum total persistent disks size (GB) allowed.
                "description": "A String", # An optional textual description of the resource.
                "zone": "A String", # Url of the zone where the machine type resides (output only).
                "maximumPersistentDisks": 42, # Maximum persistent disks allowed.
                "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this machine type.
                  "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
                  "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
                  "state": "A String", # The deprecation state. Can be "DEPRECATED", "OBSOLETE", or "DELETED". Operations which create a new resource using a "DEPRECATED" resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. New uses of "OBSOLETE" or "DELETED" resources will result in an error.
                  "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
                  "replacement": "A String", # A URL of the suggested replacement for the deprecated resource. The deprecated resource and its replacement must be resources of the same kind.
                },
                "memoryMb": 42, # Physical memory assigned to the instance, defined in MB.
                "scratchDisks": [ # List of extended scratch disks assigned to the instance.
                  {
                    "diskGb": 42, # Size of the scratch disk, defined in GB.
                  },
                ],
                "creationTimestamp": "A String", # Creation timestamp in RFC3339 text format (output only).
                "id": "A String", # Unique identifier for the resource; defined by the server (output only).
                "selfLink": "A String", # Server defined URL for the resource (output only).
                "name": "A String", # Name of the resource.
              },
            ],
            "warning": { # Informational warning which replaces the list of machine types when the list is empty.
              "message": "A String", # Optional human-readable details for this warning.
              "code": "A String", # The warning type identifier for this warning.
              "data": [ # Metadata for this warning in 'key: value' format.
                {
                  "value": "A String", # A warning data value corresponding to the key.
                  "key": "A String", # A key for the warning data.
                },
              ],
            },
          },
        },
        "kind": "compute#machineTypeAggregatedList", # Type of resource.
        "id": "A String", # Unique identifier for the resource; defined by the server (output only).
        "selfLink": "A String", # Server defined URL for this resource (output only).
      }

`aggregatedList_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`get(project, zone, machineType)`

    Returns the specified machine type resource.

    Args:
      project: string, Name of the project scoping this request. (required)
      zone: string, Name of the zone scoping this request. (required)
      machineType: string, Name of the machine type resource to return. (required)

    Returns:
      An object of the form:

        { # A machine type resource.
        "guestCpus": 42, # Count of CPUs exposed to the instance.
        "imageSpaceGb": 42, # Space allotted for the image, defined in GB.
        "kind": "compute#machineType", # Type of the resource.
        "maximumPersistentDisksSizeGb": "A String", # Maximum total persistent disks size (GB) allowed.
        "description": "A String", # An optional textual description of the resource.
        "zone": "A String", # Url of the zone where the machine type resides (output only).
        "maximumPersistentDisks": 42, # Maximum persistent disks allowed.
        "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this machine type.
          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
          "state": "A String", # The deprecation state. Can be "DEPRECATED", "OBSOLETE", or "DELETED". Operations which create a new resource using a "DEPRECATED" resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. New uses of "OBSOLETE" or "DELETED" resources will result in an error.
          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
          "replacement": "A String", # A URL of the suggested replacement for the deprecated resource. The deprecated resource and its replacement must be resources of the same kind.
        },
        "memoryMb": 42, # Physical memory assigned to the instance, defined in MB.
        "scratchDisks": [ # List of extended scratch disks assigned to the instance.
          {
            "diskGb": 42, # Size of the scratch disk, defined in GB.
          },
        ],
        "creationTimestamp": "A String", # Creation timestamp in RFC3339 text format (output only).
        "id": "A String", # Unique identifier for the resource; defined by the server (output only).
        "selfLink": "A String", # Server defined URL for the resource (output only).
        "name": "A String", # Name of the resource.
      }

`list(project, zone, maxResults=None, pageToken=None, filter=None)`

    Retrieves the list of machine type resources available to the specified project.

    Args:
      project: string, Name of the project scoping this request. (required)
      zone: string, Name of the zone scoping this request. (required)
      maxResults: integer, Optional. Maximum count of results to be returned. Maximum and default value is 100.
      pageToken: string, Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.
      filter: string, Optional. Filter expression for filtering listed resources.

    Returns:
      An object of the form:

        { # Contains a list of machine type resources.
        "nextPageToken": "A String", # A token used to continue a truncated list request (output only).
        "items": [ # The machine type resources.
          { # A machine type resource.
            "guestCpus": 42, # Count of CPUs exposed to the instance.
            "imageSpaceGb": 42, # Space allotted for the image, defined in GB.
            "kind": "compute#machineType", # Type of the resource.
            "maximumPersistentDisksSizeGb": "A String", # Maximum total persistent disks size (GB) allowed.
            "description": "A String", # An optional textual description of the resource.
            "zone": "A String", # Url of the zone where the machine type resides (output only).
            "maximumPersistentDisks": 42, # Maximum persistent disks allowed.
            "deprecated": { # Deprecation status for a public resource. # The deprecation status associated with this machine type.
              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
              "state": "A String", # The deprecation state. Can be "DEPRECATED", "OBSOLETE", or "DELETED". Operations which create a new resource using a "DEPRECATED" resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. New uses of "OBSOLETE" or "DELETED" resources will result in an error.
              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
              "replacement": "A String", # A URL of the suggested replacement for the deprecated resource. The deprecated resource and its replacement must be resources of the same kind.
            },
            "memoryMb": 42, # Physical memory assigned to the instance, defined in MB.
            "scratchDisks": [ # List of extended scratch disks assigned to the instance.
              {
                "diskGb": 42, # Size of the scratch disk, defined in GB.
              },
            ],
            "creationTimestamp": "A String", # Creation timestamp in RFC3339 text format (output only).
            "id": "A String", # Unique identifier for the resource; defined by the server (output only).
            "selfLink": "A String", # Server defined URL for the resource (output only).
            "name": "A String", # Name of the resource.
          },
        ],
        "kind": "compute#machineTypeList", # Type of resource.
        "id": "A String", # Unique identifier for the resource; defined by the server (output only).
        "selfLink": "A String", # Server defined URL for this resource (output only).
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.