- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
Returns the specified License resource.
HTTP request
GET https://compute.googleapis.com/compute/v1/projects/{project}/global/licenses/{license}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
license |
Name of the License resource to return. |
Request body
The request body must be empty.
Response body
Represents a License resource.
A License represents billing and aggregate usage data for public and marketplace images.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "kind": string, "name": string, "chargesUseFee": boolean, "id": string, "licenseCode": string, "creationTimestamp": string, "description": string, "transferable": boolean, "selfLink": string, "selfLinkWithId": string, "resourceRequirements": { "minGuestCpuCount": integer, "minMemoryMb": integer }, "appendableToDisk": boolean, "removableFromDisk": boolean, "allowedReplacementLicenses": [ string ], "osLicense": boolean, "incompatibleLicenses": [ string ], "requiredCoattachedLicenses": [ string ], "soleTenantOnly": boolean, "multiTenantOnly": boolean, "minimumRetention": { "seconds": string, "nanos": integer }, "updateTimestamp": string } |
Fields | |
---|---|
kind |
[Output Only] Type of resource. Always |
name |
Name of the resource. The name must be 1-63 characters long and comply with RFC1035. |
chargesUseFee |
[Output Only] Deprecated. This field no longer reflects whether a license charges a usage fee. |
id |
[Output Only] The unique identifier for the resource. This identifier is defined by the server. |
licenseCode |
[Output Only] The unique code used to attach this license to images, snapshots, and disks. |
creationTimestamp |
[Output Only] Creation timestamp in RFC3339 text format. |
description |
An optional textual description of the resource; provided by the client when the resource is created. |
transferable |
If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk. |
selfLink |
[Output Only] Server-defined URL for the resource. |
selfLinkWithId |
[Output Only] Server-defined URL for this resource with the resource id. |
resourceRequirements |
[Input Only] Deprecated. |
resourceRequirements.minGuestCpuCount |
[Input Only] Deprecated. This field no longer reflects the minimum number of guest cpus required to use the Instance. |
resourceRequirements.minMemoryMb |
[Input Only] Deprecated. This field no longer reflects the minimum memory required to use the Instance. |
appendableToDisk |
If true, this license can be appended to an existing disk's set of licenses. |
removableFromDisk |
If true, this license can be removed from a disk's set of licenses, with no replacement license needed. |
allowedReplacementLicenses[] |
Specifies licenseCodes of licenses that can replace this license. Note: such replacements are allowed even if removableFromDisk is false. |
osLicense |
If true, indicates this is an OS license. Only one OS license can be attached to a disk or image at a time. |
incompatibleLicenses[] |
Specifies licenseCodes of licenses that are incompatible with this license. If a license is incompatible with this license, it cannot be attached to the same disk or image. |
requiredCoattachedLicenses[] |
Specifies the set of permissible coattached licenseCodes of licenses that satisfy the coattachment requirement of this license. At least one license from the set must be attached to the same disk or image as this license. |
soleTenantOnly |
If true, this license can only be used on VMs on sole tenant nodes. |
multiTenantOnly |
If true, this license can only be used on VMs on multi tenant nodes. |
minimumRetention |
If set, this license will be unable to be removed or replaced once attached to a disk until the minimumRetention period has passed. |
minimumRetention.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
minimumRetention.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
updateTimestamp |
[Output Only] Last update timestamp in RFC3339 text format. |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute.readonly
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.licenses.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles.