# 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, Project ID for this request. (required)
      maxResults: integer, Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.
      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", # [Output Only] A token used to continue a truncated list request.
        "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", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
                "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", # [Output Only] Creation timestamp in RFC3339 text format.
                "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
                "selfLink": "A String", # [Output Only] Server defined URL for the resource.
                "name": "A String", # Name of the resource.
              },
            ],
            "warning": { # An informational warning that appears when the machine types 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", # [Output Only] Unique identifier for the resource; defined by the server.
        "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, Project ID for 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", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
        "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", # [Output Only] Creation timestamp in RFC3339 text format.
        "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
        "selfLink": "A String", # [Output Only] Server defined URL for the resource.
        "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, Project ID for this request. (required)
      zone: string, Name of the zone scoping this request. (required)
      maxResults: integer, Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.
      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": [ # A list of MachineType 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", # [Output Only] The name of the zone where the machine type resides, such as us-central1-a.
            "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", # [Output Only] Creation timestamp in RFC3339 text format.
            "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
            "selfLink": "A String", # [Output Only] Server defined URL for the resource.
            "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.