--- title: "GET /projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks" method: GET path: "/projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks" tags: ["reservationSubBlocks"] --- # GET /projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks `GET /projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks` ## Request - Base URL: `https://compute.googleapis.com/compute/v1` - URL: `https://compute.googleapis.com/compute/v1/projects/{project}/zones/{zone}/reservations/{reservationsId}/reservationBlocks/{reservationBlocksId}/reservationSubBlocks` - Auth: one of: - OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/cloud-platform` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform` - OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/compute` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/compute` - OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/compute.readonly` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/compute.readonly` Retrieves a list of reservation subBlocks under a single reservation. ## Path parameters - `reservationsId` string, required - `reservationBlocksId` string, required - `project` string, required - `zone` string, required ## Query parameters - `filter` string - `maxResults` integer - `orderBy` string - `pageToken` string - `returnPartialSuccess` boolean ## Response `200` Successful response - ReservationSubBlocksListResponse: A list of reservation subBlocks under a single reservation. - `id` string: Unique identifier for the resource; defined by the server. - `items` ReservationSubBlock[]: A list of reservation subBlock resources. - `acceleratorTopologiesInfo` AcceleratorTopologiesInfo: Info for accelerator topologies within a densely packed reservation. - `acceleratorTopologyInfos` AcceleratorTopologiesInfoAcceleratorTopologyInfo[]: Info for each accelerator topology. - `acceleratorTopology` string: The accelerator topology. - `infoPerTopologyStates` AcceleratorTopologiesInfoAcceleratorTopologyInfoInfoPerTopologyState[]: Info for each topology state. - `count` integer: The number of accelerator topologies in this state. - `state` 'AVAILABLE' | 'DEGRADED' | 'RUNNING' | 'TOPOLOGY_STATE_UNSPECIFIED' | 'UNHEALTHY': The state of the accelerator topology. - `count` integer: Output only. [Output Only] The number of hosts that are allocated in this reservation subBlock. - `creationTimestamp` string: Output only. [Output Only] Creation timestamp inRFC3339 text format. - `healthInfo` ReservationSubBlockHealthInfo: Health information for the reservation subBlock. - `degradedHostCount` integer: The number of degraded hosts in the reservation subBlock. - `degradedInfraCount` integer: The number of degraded infrastructure (e.g NV link domain) in the reservation subblock. - `healthStatus` 'DEGRADED' | 'HEALTHY' | 'HEALTH_STATUS_UNSPECIFIED': The health status of the reservation subBlock. - `healthyHostCount` integer: The number of healthy hosts in the reservation subBlock. - `healthyInfraCount` integer: The number of healthy infrastructure (e.g NV link domain) in the reservation subblock. - `id` string, uint64: Output only. [Output Only] The unique identifier for the resource. This identifier is defined by the server. - `inUseCount` integer: Output only. [Output Only] The number of instances that are currently in use on this reservation subBlock. - `inUseHostCount` integer: Output only. Number of hosts currently in use. If there is one or more Instances running on the host, it is considered in use. - `kind` string: Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks. - `name` string: Output only. [Output Only] The name of this reservation subBlock generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])? - `physicalTopology` ReservationSubBlockPhysicalTopology - `block` string: The hash of the capacity block within the cluster. - `cluster` string: The cluster name of the reservation subBlock. - `subBlock` string: The hash of the capacity sub-block within the capacity block. - `reservationSubBlockMaintenance` GroupMaintenanceInfo: Maintenance Info for ReservationBlocks. - `instanceMaintenanceOngoingCount` integer: Describes number of instances that have ongoing maintenance. - `instanceMaintenancePendingCount` integer: Describes number of instances that have pending maintenance. - `maintenanceOngoingCount` integer: Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have ongoing maintenance. - `maintenancePendingCount` integer: Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have pending maintenance. - `schedulingType` 'GROUPED' | 'GROUP_MAINTENANCE_TYPE_UNSPECIFIED' | 'INDEPENDENT': The type of maintenance for the reservation. - `subblockInfraMaintenanceOngoingCount` integer: Describes number of subblock Infrastructure that has ongoing maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family(e.g. NVLink Domains). Not all VM Families will support this field. - `subblockInfraMaintenancePendingCount` integer: Describes number of subblock Infrastructure that has pending maintenance. Here, Subblock Infrastructure Maintenance pertains to upstream hardware contained in the Subblock that is necessary for a VM Family (e.g. NVLink Domains). Not all VM Families will support this field. - `upcomingGroupMaintenance` UpcomingMaintenance: Upcoming Maintenance notification information. - `canReschedule` boolean: Indicates if the maintenance can be customer triggered. - `latestWindowStartTime` string: The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. - `maintenanceOnShutdown` boolean: Indicates whether the UpcomingMaintenance will be triggered on VM shutdown. - `maintenanceReasons` string[]: The reasons for the maintenance. Only valid for vms. - `maintenanceStatus` 'ONGOING' | 'PENDING' | 'UNKNOWN' - `type` 'MULTIPLE' | 'SCHEDULED' | 'UNKNOWN_TYPE' | 'UNSCHEDULED': Defines the type of maintenance. - `windowEndTime` string: The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format. - `windowStartTime` string: The current start time of the maintenance window. This timestamp value is in RFC3339 text format. - `selfLink` string: Output only. [Output Only] Server-defined fully-qualified URL for this resource. - `selfLinkWithId` string: Output only. [Output Only] Server-defined URL for this resource with the resource id. - `status` 'CREATING' | 'DELETING' | 'INVALID' | 'READY': Output only. [Output Only] Status of the reservation subBlock. - `zone` string: Output only. [Output Only] Zone in which the reservation subBlock resides. - `kind` string: Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation subBlocks. - `nextPageToken` string: This token allows you to get the next page of results for list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. - `selfLink` string: Server-defined URL for this resource. - `warning` object: Informational warning message. - `code` 'CLEANUP_FAILED' | 'DEPRECATED_RESOURCE_USED' | 'DEPRECATED_TYPE_USED' | 'DISK_SIZE_LARGER_THAN_IMAGE_SIZE' | 'EXPERIMENTAL_TYPE_USED' | 'EXTERNAL_API_WARNING' | 'FIELD_VALUE_OVERRIDEN' | 'INJECTED_KERNELS_DEPRECATED' | 'INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB' | 'LARGE_DEPLOYMENT_WARNING' | 'LIST_OVERHEAD_QUOTA_EXCEED' | 'MISSING_TYPE_DEPENDENCY' | 'NEXT_HOP_ADDRESS_NOT_ASSIGNED' | 'NEXT_HOP_CANNOT_IP_FORWARD' | 'NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE' | 'NEXT_HOP_INSTANCE_NOT_FOUND' | 'NEXT_HOP_INSTANCE_NOT_ON_NETWORK' | 'NEXT_HOP_NOT_RUNNING' | 'NOT_CRITICAL_ERROR' | 'NO_RESULTS_ON_PAGE' | 'PARTIAL_SUCCESS' | 'QUOTA_INFO_UNAVAILABLE' | 'REQUIRED_TOS_AGREEMENT' | 'RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING' | 'RESOURCE_NOT_DELETED' | 'SCHEMA_VALIDATION_IGNORED' | 'SINGLE_INSTANCE_PROPERTY_TEMPLATE' | 'UNDECLARED_PROPERTIES' | 'UNREACHABLE': [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. - `data` object[]: [Output Only] Metadata about this warning in key: value format. For example: "data": [ { "key": "scope", "value": "zones/us-east1-d" }] - `key` string: [Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding). - `value` string: [Output Only] A warning data value corresponding to the key. - `message` string: [Output Only] A human-readable description of the warning code. ## Changes - **2026-10-30** `8b85e897d3dc`: 4 info - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2` - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c` - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2` - the security scope `https://www.googleapis.com/auth/compute.readonly` was removed from the endpoint's security scheme `Oauth2c` [Operation history](https://skmtc.dev/google/apis/compute/changes/projects/:project/zones/:zone/reservations/:reservationsId/reservationBlocks/:reservationBlocksId/reservationSubBlocks/get.md) --- [API](https://skmtc.dev/google/apis/compute.md) - [All operations](https://skmtc.dev/google/apis/compute/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/compute/revisions/8b85e897d3dc?raw)