Compute Engine API . machineTypes

Instance Methods

get(project, machineType)

Returns the specified machine type resource.

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

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

list_next(previous_request, previous_response)

Retrieves the next page of results.

Method Details

get(project, machineType)
Returns the specified machine type resource.

Args:
  project: string, Name of the project 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.
    "ephemeralDisks": [ # List of extended ephemeral disks assigned to the instance.
      {
        "diskGb": 42, # Size of the ephemeral disk, defined in GB.
      },
    ],
    "maximumPersistentDisksSizeGb": "A String", # Maximum total persistent disks size (GB) allowed.
    "description": "A String", # An optional textual description of the resource.
    "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.
    "availableZone": [ # The zones that this machine type can run in.
      "A String",
    ],
    "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, 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)
  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.
        "ephemeralDisks": [ # List of extended ephemeral disks assigned to the instance.
          {
            "diskGb": 42, # Size of the ephemeral disk, defined in GB.
          },
        ],
        "maximumPersistentDisksSizeGb": "A String", # Maximum total persistent disks size (GB) allowed.
        "description": "A String", # An optional textual description of the resource.
        "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.
        "availableZone": [ # The zones that this machine type can run in.
          "A String",
        ],
        "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.