Requires authorization
Retrieves the list of persistent disk resources contained within the specified zone. Try it now .
Request
HTTP request
GET https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
project
|
string
|
Project ID of the project scoping this request. |
zone
|
string
|
Name of the zone scoping this request. |
Optional query parameters | ||
filter
|
string
|
Filter expression for filtering listed resources, in the form
filter={expression}
. Your
{expression}
must contain the following:
<field_name> <comparison_string> <literal_string>
For example: filter=status ne RUNNING
The above filter returns only results whose
filter=status ne "RUNNING" filter=status ne 'RUNNING' filter=status ne RUNNING If you use a complex regular expression, you need to encode the special characters, including quotes. Consider the following regular expression: name eq '.*/my_instance_[0-9]+' To use the expression, you would need to encode it: filter=name%20eq%20%27.%2A%2Fmy_ |
maxResults
|
unsigned integer
|
Maximum count of results to be returned. Maximum and default value is
100
.
Acceptable values are
0
to
500
, inclusive.
(Default:
100
)
|
pageToken
|
string
|
Specifies a
nextPageToken
returned by a previous list request. This token can be used to request the next page of results from a previous list request.
|
Authorization
This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).
Scope |
---|
https://www.googleapis.com/auth/compute.readonly
|
https://www.googleapis.com/auth/compute
|
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{ "kind": "compute#diskList", "selfLink": string, "id": string, "items": [ disks Resource ], "nextPageToken": string }
Property name | Value | Description | Notes |
---|---|---|---|
kind
|
string
|
[Ouput Only]
Type of resource. Always
compute#diskList
for a list of Disk resources.
|
|
selfLink
|
string
|
[Output Only] Server-defined fully-qualified URL for this resource. | |
id
|
string
|
[Output Only] Unique identifier for the resource. This is generated by the server. | |
items[]
|
list
|
[Output Only] The list of Persistent Disk resources. | |
nextPageToken
|
string
|
[Output Only]
A token generated by the server if the number of results exceeds the
maxResults
value. This token can be used to retrieve the next page of results in a separate list request.
|
Try it!
Use the APIs Explorer below to call this method on live data and see the response.