- HTTP request
- Path parameters
- Request body
- Response body
- Authorization Scopes
- IAM Permissions
- Examples
- Try it!
Returns the specified machine type. Gets a list of available machine types by making a list()
request.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/zones/{zone}/machineTypes/{resourceId}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
zone |
The name of the zone for this request. |
resourceId |
Name of the machine type to return. |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
JSON representation | |
---|---|
{ "id": string, "creationTimestamp": string, "name": string, "description": string, "guestCpus": integer, "memoryMb": integer, "maximumPersistentDisks": integer, "maximumPersistentDisksSizeGb": string, "deprecated": { "state": enum, "replacement": string, "deprecated": string, "obsolete": string, "deleted": string }, "zone": string, "selfLink": string, "isSharedCpu": boolean, "accelerators": [ { "guestAcceleratorType": string, "guestAcceleratorCount": integer } ], "kind": string } |
Fields | |
---|---|
id |
[Output Only] The unique identifier for the resource. This identifier is defined by the server. |
creationTimestamp |
[Output Only] Creation timestamp in RFC3339 text format. |
name |
[Output Only] Name of the resource. |
description |
[Output Only] An optional textual description of the resource. |
guestCpus |
[Output Only] The number of virtual CPUs that are available to the instance. |
memoryMb |
[Output Only] The amount of physical memory available to the instance, defined in MB. |
maximumPersistentDisks |
[Output Only] Maximum persistent disks allowed. |
maximumPersistentDisksSizeGb |
[Output Only] Maximum total persistent disks size (GB) allowed. |
deprecated |
[Output Only] The deprecation status associated with this machine type. Only applicable if the machine type is unavailable. |
deprecated.state |
The deprecation state of this resource. This can be |
deprecated.replacement |
The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource. |
deprecated.deprecated |
An optional RFC3339 timestamp on or after which the state of this resource is intended to change to |
deprecated.obsolete |
An optional RFC3339 timestamp on or after which the state of this resource is intended to change to |
deprecated.deleted |
An optional RFC3339 timestamp on or after which the state of this resource is intended to change to |
zone |
[Output Only] The name of the zone where the machine type resides, such as us-central1-a. |
selfLink |
[Output Only] Server-defined URL for the resource. |
isSharedCpu |
[Output Only] Whether this machine type has a shared CPU. See Shared-core machine types for more information. |
accelerators[] |
[Output Only] A list of accelerator configurations assigned to this machine type. |
accelerators[].guestAcceleratorType |
The accelerator type resource name, not a full URL, e.g. 'nvidia-tesla-k80'. |
accelerators[].guestAcceleratorCount |
Number of accelerator cards exposed to the guest. |
kind |
[Output Only] The type of the resource. Always |
Authorization Scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
In addition to any permissions specified on the fields above, authorization requires one or more of the following IAM permissions:
compute.machineTypes.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles.