Google Cloud Platform provides graphics processing units (accelerators) that you can add to VM instances to improve or accelerate performance when working with intensive workloads. For more information, readGPUs on Compute Engine.
If successful, the response body contains data with the following structure:
[Output Only] An optional textual description of the resource.
deprecated
object
[Output Only] The deprecation status associated with this accelerator type.
deprecated.state
enum
The deprecation state of this resource. This can beACTIVE,DEPRECATED,OBSOLETE, orDELETED. Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATEDresource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which useOBSOLETEorDELETEDresources will be rejected and result in an error.
deprecated.replacement
string
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
string
An optionalRFC3339timestamp on or after which the state of this resource is intended to change toDEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
deprecated.obsolete
string
An optionalRFC3339timestamp on or after which the state of this resource is intended to change toOBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
deprecated.deleted
string
An optionalRFC3339timestamp on or after which the state of this resource is intended to change toDELETED. This is only informational and the status will not change unless the client explicitly changes it.
zone
string
[Output Only] The name of the zone where the accelerator type resides, such as us-central1-a. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
selfLink
string
[Output Only] Server-defined, fully qualified URL for this resource.
maximumCardsPerInstance
integer
[Output Only] Maximum number of accelerator cards allowed per instance.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-28 UTC."],[[["\u003cp\u003eThis page details how to retrieve information about a specific accelerator type using a \u003ccode\u003eGET\u003c/code\u003e request to the Google Cloud Compute Engine API.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the \u003ccode\u003eproject\u003c/code\u003e, \u003ccode\u003ezone\u003c/code\u003e, and \u003ccode\u003eacceleratorType\u003c/code\u003e as path parameters in the URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response returns data about the specified accelerator type in JSON format, including details such as its ID, name, description, and deprecation status.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires proper authorization, using one of the following OAuth scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/compute.readonly\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/compute\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e, and one of the IAM permissions: \u003ccode\u003ecompute.acceleratorTypes.get\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: acceleratorTypes.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.AcceleratorType.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nReturns the specified accelerator type.\n\n### HTTP request\n\n`GET https://compute.googleapis.com/compute/v1/projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nRepresents an Accelerator Type resource.\n\nGoogle Cloud Platform provides graphics processing units (accelerators) that you can add to VM instances to improve or accelerate performance when working with intensive workloads. For more information, read [GPUs on Compute Engine](/compute/docs/gpus).\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/compute.readonly`\n- `\n https://www.googleapis.com/auth/compute`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nIn addition to any permissions specified on the fields above, authorization requires one or more of the following [IAM](https://cloud.google.com/iam/docs/) permissions:\n\n- `compute.acceleratorTypes.get`\n\nTo find predefined roles that contain those permissions, see [Compute Engine IAM Roles](/compute/docs/access/iam)."]]
