- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
Returns all the details of a specific multi-MIG.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/regions/{region}/multiMigs/{multiMig}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
region |
Name of the region for this request. |
multiMig |
Name of the multi-MIG resource to return. |
Request body
The request body must be empty.
Response body
Multi-MIG represents a group of managed instance groups.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "kind": string, "id": string, "creationTimestamp": string, "name": string, "description": string, "selfLink": string, "region": string, "resourcePolicies": { "workloadPolicy": string }, "status": { "appliedAcceleratorTopologies": [ { "acceleratorTopology": string, "acceleratorTopologyState": enum, "acceleratorTopologyStateLastCheck": { "timestamp": string, "error": { "errors": [ { "code": string, "location": string, "message": string, "errorDetails": [ { // Union field |
Fields | |
---|---|
kind |
[Output only] Type of the resource. Always |
id |
[Output only] The unique identifier for this resource type. The server generates this identifier. |
creationTimestamp |
[Output only] The creation timestamp of this multi-MIG in RFC3339 text format. |
name |
The name of the multi-MIG. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression |
description |
An optional description of this resource. |
selfLink |
[Output only] Server-defined URL for the resource. |
region |
[Output only] The URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. You cannot set the region as a field in the request body. |
resourcePolicies |
Resource policies for this multi-MIG. |
resourcePolicies.workloadPolicy |
The URL of the workload policy for this multi-MIG. It can be a full or partial URL. For example, the following are all valid URLs to a workload policy:
|
status |
|
status.appliedAcceleratorTopologies[] |
[Output Only] The accelerator topology applied to this multi-MIG. Currently only one accelerator topology is supported. |
status.appliedAcceleratorTopologies[].acceleratorTopology |
[Output Only] Topology in the format of: "16x16", "4x4x4", etc. The value is the same as configured in the WorkloadPolicy. |
status.appliedAcceleratorTopologies[].acceleratorTopologyState |
[Output Only] The state of the accelerator topology. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck |
[Output Only] The result of the latest accelerator topology state check. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.timestamp |
[Output Only] Timestamp is shown only if there is an error. The field has // RFC3339 // text format. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error |
[Output Only] Encountered errors on the last state check. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[] |
[Output Only] The array of errors encountered while processing this operation. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].code |
[Output Only] The error type identifier for this error. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].location |
[Output Only] Indicates the field in the request that caused the error. This property is optional. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].message |
[Output Only] An optional, human-readable error message. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[] |
[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].errorInfo |
|
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].errorInfo.reason |
The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].errorInfo.domain |
The logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: "pubsub.googleapis.com". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is "googleapis.com". |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].errorInfo.metadatas |
Additional structured details about this error. Keys must match a regular expression of |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].quotaInfo |
|
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].quotaInfo.metricName |
The Compute Engine quota metric name. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].quotaInfo.limitName |
The name of the quota limit. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].quotaInfo.dimensions |
The map holding related quota dimensions. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].quotaInfo.limit |
Current effective quota limit. The limit's unit depends on the quota type or metric. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].quotaInfo.futureLimit |
Future quota limit being rolled out. The limit's unit depends on the quota type or metric. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].quotaInfo.rolloutStatus |
Rollout status of the future quota limit. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].help |
|
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].help.links[] |
URL(s) pointing to additional information on handling the current error. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].help.links[].description |
Describes what the link offers. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].help.links[].url |
The URL of the link. |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].localizedMessage |
|
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].localizedMessage.locale |
The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", "fr-CH", "es-MX" |
status.appliedAcceleratorTopologies[].acceleratorTopologyStateLastCheck.error.errors[].errorDetails[].localizedMessage.message |
The localized error message in the above locale. |
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.multiMig.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles.