| <html><body> | |
| <style> | |
| body, h1, h2, h3, div, span, p, pre, a { | |
| margin: 0; | |
| padding: 0; | |
| border: 0; | |
| font-weight: inherit; | |
| font-style: inherit; | |
| font-size: 100%; | |
| font-family: inherit; | |
| vertical-align: baseline; | |
| } | |
| body { | |
| font-size: 13px; | |
| padding: 1em; | |
| } | |
| h1 { | |
| font-size: 26px; | |
| margin-bottom: 1em; | |
| } | |
| h2 { | |
| font-size: 24px; | |
| margin-bottom: 1em; | |
| } | |
| h3 { | |
| font-size: 20px; | |
| margin-bottom: 1em; | |
| margin-top: 1em; | |
| } | |
| pre, code { | |
| line-height: 1.5; | |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; | |
| } | |
| pre { | |
| margin-top: 0.5em; | |
| } | |
| h1, h2, h3, p { | |
| font-family: Arial, sans serif; | |
| } | |
| h1, h2, h3 { | |
| border-bottom: solid #CCC 1px; | |
| } | |
| .toc_element { | |
| margin-top: 0.5em; | |
| } | |
| .firstline { | |
| margin-left: 2 em; | |
| } | |
| .method { | |
| margin-top: 1em; | |
| border: solid 1px #CCC; | |
| padding: 1em; | |
| background: #EEE; | |
| } | |
| .details { | |
| font-weight: bold; | |
| font-size: 14px; | |
| } | |
| </style> | |
| <h1><a href="compute_preview.html">Compute Engine API</a> . <a href="compute_preview.futureReservations.html">futureReservations</a></h1> | |
| <h2>Instance Methods</h2> | |
| <p class="toc_element"> | |
| <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Retrieves an aggregated list of future reservations.</p> | |
| <p class="toc_element"> | |
| <code><a href="#aggregatedList_next">aggregatedList_next(previous_request, previous_response)</a></code></p> | |
| <p class="firstline">Retrieves the next page of results.</p> | |
| <p class="toc_element"> | |
| <code><a href="#cancel">cancel(project, zone, futureReservation, requestId=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Cancel the specified future reservation.</p> | |
| <p class="toc_element"> | |
| <code><a href="#close">close()</a></code></p> | |
| <p class="firstline">Close httplib2 connections.</p> | |
| <p class="toc_element"> | |
| <code><a href="#delete">delete(project, zone, futureReservation, requestId=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Deletes the specified future reservation.</p> | |
| <p class="toc_element"> | |
| <code><a href="#get">get(project, zone, futureReservation, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Retrieves information about the specified future reservation.</p> | |
| <p class="toc_element"> | |
| <code><a href="#insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Creates a new Future Reservation.</p> | |
| <p class="toc_element"> | |
| <code><a href="#list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">A list of all the future reservations that have been configured for the</p> | |
| <p class="toc_element"> | |
| <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> | |
| <p class="firstline">Retrieves the next page of results.</p> | |
| <p class="toc_element"> | |
| <code><a href="#update">update(project, zone, futureReservation, body=None, requestId=None, updateMask=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Updates the specified future reservation.</p> | |
| <h3>Method Details</h3> | |
| <div class="method"> | |
| <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, serviceProjectNumber=None, x__xgafv=None)</code> | |
| <pre>Retrieves an aggregated list of future reservations. | |
| To prevent failure, it is recommended that you set the | |
| `returnPartialSuccess` parameter to `true`. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| filter: string, A filter expression that filters resources listed in the response. Most | |
| Compute resources support two types of filter expressions: | |
| expressions that support regular expressions and expressions that follow | |
| API improvement proposal AIP-160. | |
| These two types of filter expressions cannot be mixed in one request. | |
| If you want to use AIP-160, your expression must specify the field name, an | |
| operator, and the value that you want to use for filtering. The value | |
| must be a string, a number, or a boolean. The operator | |
| must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. | |
| For example, if you are filtering Compute Engine instances, you can | |
| exclude instances named `example-instance` by specifying | |
| `name != example-instance`. | |
| The `:*` comparison can be used to test whether a key has been defined. | |
| For example, to find all objects with `owner` label use: | |
| ``` | |
| labels.owner:* | |
| ``` | |
| You can also filter nested fields. For example, you could specify | |
| `scheduling.automaticRestart = false` to include instances only | |
| if they are not scheduled for automatic restarts. You can use filtering | |
| on nested fields to filter based onresource labels. | |
| To filter on multiple expressions, provide each separate expression within | |
| parentheses. For example: | |
| ``` | |
| (scheduling.automaticRestart = true) | |
| (cpuPlatform = "Intel Skylake") | |
| ``` | |
| By default, each expression is an `AND` expression. However, you | |
| can include `AND` and `OR` expressions explicitly. | |
| For example: | |
| ``` | |
| (cpuPlatform = "Intel Skylake") OR | |
| (cpuPlatform = "Intel Broadwell") AND | |
| (scheduling.automaticRestart = true) | |
| ``` | |
| If you want to use a regular expression, use the `eq` (equal) or `ne` | |
| (not equal) operator against a single un-parenthesized expression with or | |
| without quotes or against multiple parenthesized expressions. Examples: | |
| `fieldname eq unquoted literal` | |
| `fieldname eq 'single quoted literal'` | |
| `fieldname eq "double quoted literal"` | |
| `(fieldname1 eq literal) (fieldname2 ne "literal")` | |
| The literal value is interpreted as a regular expression using GoogleRE2 library syntax. | |
| The literal value must match the entire field. | |
| For example, to filter for instances that do not end with name "instance", | |
| you would use `name ne .*instance`. | |
| You cannot combine constraints on multiple fields using regular | |
| expressions. | |
| includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region, | |
| global) should be included in the response. For new resource types added | |
| after this field, the flag has no effect as new resource types will always | |
| include every visible scope for each scope type in response. For resource | |
| types which predate this field, if this flag is omitted or false, only | |
| scopes of the scope types where the resource type is expected to be found | |
| will be included. | |
| maxResults: integer, The maximum number of results per page that should be returned. | |
| If the number of available results is larger than `maxResults`, | |
| Compute Engine returns a `nextPageToken` that can be used to get | |
| the next page of results in subsequent list requests. Acceptable values are | |
| `0` to `500`, inclusive. (Default: `500`) | |
| orderBy: string, Sorts list results by a certain order. By default, results | |
| are returned in alphanumerical order based on the resource name. | |
| You can also sort results in descending order based on the creation | |
| timestamp using `orderBy="creationTimestamp desc"`. This sorts | |
| results based on the `creationTimestamp` field in | |
| reverse chronological order (newest result first). Use this to sort | |
| resources like operations so that the newest operation is returned first. | |
| Currently, only sorting by `name` or | |
| `creationTimestamp desc` is supported. | |
| pageToken: string, Specifies a page token to use. Set `pageToken` to the | |
| `nextPageToken` returned by a previous list request to get | |
| the next page of results. | |
| serviceProjectNumber: string, The Shared VPC service project id or service project number for which | |
| aggregated list request is invoked for subnetworks list-usable api. | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Contains a list of future reservations. | |
| "etag": "A String", | |
| "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server. | |
| "items": { # A list of Future reservation resources. | |
| "a_key": { # Name of the scope containing this set of future reservations. | |
| "futureReservations": [ # A list of future reservations contained in this scope. | |
| { | |
| "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation. | |
| # count of CPUs) and can account for multiple instance SKUs. In other words, | |
| # one can create instances of varying shapes against this reservation. | |
| "inUseResources": [ # Output only. [Output only] List of resources currently in use. | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators). | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must | |
| # belong to. | |
| "workloadType": "A String", # The workload type of the instances that will target this reservation. | |
| }, | |
| "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by | |
| # Compute Engine. Format of this field must be a valid | |
| # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. | |
| "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations. | |
| # It represents relative time to future reservation start_time when | |
| # auto-created reservations will be automatically deleted by Compute | |
| # Engine. Duration time unit is represented as a count of seconds | |
| # and fractions of seconds at nanosecond resolution. | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created | |
| # reservation. If set to true, auto-created reservations will be | |
| # deleted at Future Reservation's end time (default) or at user's defined | |
| # timestamp if any of the | |
| # [auto_created_reservations_delete_time, auto_created_reservations_duration] | |
| # values is specified. | |
| # For keeping auto-created reservation indefinitely, this value should be set | |
| # to false. | |
| "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate | |
| # intent for reserving capacity in the same cluster as the colocation | |
| # resource. | |
| "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an | |
| # existing commitment. | |
| "commitmentName": "A String", # name of the commitment where capacity is being delivered to. | |
| "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If | |
| # this field is not present, then no | |
| # commitment needs to be created. | |
| "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all | |
| # parent commitments will be extended to match the end date of the plan for | |
| # this commitment. | |
| }, | |
| "confidentialComputeType": "A String", | |
| "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339 | |
| # text format. | |
| "deploymentType": "A String", # Type of the deployment requested as part of future reservation. | |
| "description": "A String", # An optional description of this resource. Provide this property when you | |
| # create the future reservation. | |
| "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled. | |
| "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server | |
| # defines this identifier. | |
| "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. | |
| "name": "A String", # The name of the resource, provided by the client when initially creating | |
| # the resource. The resource name must be 1-63 characters long, and comply | |
| # withRFC1035. | |
| # Specifically, the name must be 1-63 characters long and match the regular | |
| # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first | |
| # character must be a lowercase letter, and all following characters must be | |
| # a dash, lowercase letter, or digit, except the last character, which cannot | |
| # be a dash. | |
| "namePrefix": "A String", # Name prefix for the reservations to be created at the time of | |
| # delivery. The name prefix must comply with RFC1035. | |
| # Maximum allowed length for name prefix is 20. Automatically created | |
| # reservations name format will be -date-####. | |
| "params": { # Additional future reservation params. # Input only. Additional params passed with the request, but not persisted | |
| # as part of resource payload. | |
| "resourceManagerTags": { # Input only. Resource manager tags to be bound to the future reservation. Tag keys and | |
| # values have the same definition as resource | |
| # manager tags. Keys and values can be either in numeric format, | |
| # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in | |
| # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and | |
| # `{tag_value_short_name}`. The field is ignored (both PUT & | |
| # PATCH) when empty. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| "planningStatus": "A String", # Planning state before being submitted for evaluation | |
| "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and | |
| # expected pricing. | |
| "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of | |
| # delivery of future reservations. If the reservation with the given name | |
| # does not exist already, it is created automatically at the time of Approval | |
| # with INACTIVE state till specified start-time. Either provide the | |
| # reservation_name or a name_prefix. | |
| "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation | |
| # resource. It is populated for each instance of the FutureReservation | |
| # resource, and includes the api_version the | |
| # instance was retrieved through, and its canonical | |
| # resource_type name. | |
| "apiVersion": "A String", # The version of the API interface that this resource was retrieved through. | |
| # For example, `"2025-01-01"` or `"2025-01-01-preview"`. | |
| "resourceType": "A String", # The canonical resource type name in the format of a resource type | |
| # as defined by [AIP-123](https://google.aip.dev/123). | |
| # For example, `"compute.googleapis.com/Instance"`. | |
| }, | |
| "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to | |
| # RFC1035. This will be the name of storage pool or Exapool for persistent | |
| # disk FRs. | |
| "schedulingType": "A String", # Maintenance information for this reservation | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. | |
| "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with | |
| # affinity for "any" reservation. If the field is set, then only VMs that | |
| # target the reservation by name can consume from the delivered reservation. | |
| "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and | |
| # total count. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation | |
| "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment. | |
| "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at | |
| # start_time. | |
| "A String", | |
| ], | |
| "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future | |
| # reservation. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during | |
| # "PROVISIONING" state. This count also includes capacity delivered as part | |
| # of existing matching reservations. | |
| "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an | |
| # amendment was requested. If the amendment is declined, the Future | |
| # Reservation will be reverted to the last known good state. The last known | |
| # good state is not set when updating a future reservation whose | |
| # Procurement Status is DRAFTING. | |
| # amendment be declined. | |
| "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an | |
| # amendment was requested. | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future | |
| # reservation before an amendment was requested. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the | |
| # Future Reservation. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| }, | |
| "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an | |
| # amendment was requested. | |
| "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an | |
| # amendment was requested. | |
| "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future | |
| # Reservation. | |
| }, | |
| "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no | |
| # modifications to Future Reservation will be allowed. Applicable only | |
| # after the Future Reservation is in the APPROVED state. The lock_time is | |
| # an RFC3339 string. The procurement_status will transition to PROCURING | |
| # state at this time. | |
| "procurementStatus": "A String", # Output only. Current state of this Future Reservation | |
| "specificSkuProperties": { # Properties to be set for the Future Reservation. | |
| "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation | |
| # properties. | |
| }, | |
| "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| }, | |
| "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation. | |
| "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| "storagePoolType": "A String", # Type of the storage pool. | |
| }, | |
| "timeWindow": { # Time window for this Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides. | |
| }, | |
| ], | |
| "warning": { # Informational warning which replaces the list of future reservations when | |
| # the list is empty. | |
| "code": "A String", # [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": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A 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": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| }, | |
| }, | |
| "kind": "compute#futureReservationsAggregatedListResponse", # Output only. [Output Only] Type of resource. Alwayscompute#futureReservationsAggregatedListResponse for future | |
| # resevation aggregated list response. | |
| "nextPageToken": "A String", # [Output Only] 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": "A String", # Output only. [Output Only] Server-defined URL for this resource. | |
| "unreachables": [ # Output only. [Output Only] Unreachable resources. | |
| "A String", | |
| ], | |
| "warning": { # [Output Only] Informational warning message. | |
| "code": "A String", # [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": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A 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": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="aggregatedList_next">aggregatedList_next(previous_request, previous_response)</code> | |
| <pre>Retrieves the next page of results. | |
| Args: | |
| previous_request: The request for the previous page. (required) | |
| previous_response: The response from the request for the previous page. (required) | |
| Returns: | |
| A request object that you can call 'execute()' on to request the next | |
| page. Returns None if there are no more items in the collection. | |
| </pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="cancel">cancel(project, zone, futureReservation, requestId=None, x__xgafv=None)</code> | |
| <pre>Cancel the specified future reservation. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| zone: string, Name of the zone for this request. Name should conform to RFC1035. (required) | |
| futureReservation: string, Name of the future reservation to retrieve. Name should conform to RFC1035. (required) | |
| requestId: string, An optional request ID to identify requests. Specify a unique request ID so | |
| that if you must retry your request, the server will know to ignore the | |
| request if it has already been completed. | |
| For example, consider a situation where you make an initial request and | |
| the request times out. If you make the request again with the same | |
| request ID, the server can check if original operation with the same | |
| request ID was received, and if so, will ignore the second request. This | |
| prevents clients from accidentally creating duplicate commitments. | |
| The request ID must be | |
| a valid UUID with the exception that zero UUID is not supported | |
| (00000000-0000-0000-0000-000000000000). | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Represents an Operation resource. | |
| # | |
| # Google Compute Engine has three Operation resources: | |
| # | |
| # * [Global](/compute/docs/reference/rest/v1/globalOperations) | |
| # * [Regional](/compute/docs/reference/rest/v1/regionOperations) | |
| # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) | |
| # | |
| # You can use an operation resource to manage asynchronous API requests. | |
| # For more information, readHandling | |
| # API responses. | |
| # | |
| # Operations can be global, regional or zonal. | |
| # | |
| # - For global operations, use the `globalOperations` | |
| # resource. | |
| # - For regional operations, use the | |
| # `regionOperations` resource. | |
| # - For zonal operations, use | |
| # the `zoneOperations` resource. | |
| # | |
| # | |
| # | |
| # For more information, read | |
| # Global, Regional, and Zonal Resources. | |
| # | |
| # Note that completed Operation resources have a limited | |
| # retention period. | |
| "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. | |
| # Not present otherwise. | |
| "creationTimestamp": "A String", # [Deprecated] This field is deprecated. | |
| "description": "A String", # [Output Only] A textual description of the operation, which is | |
| # set when the operation is created. | |
| "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339 | |
| # text format. | |
| "error": { # [Output Only] If errors are generated during processing of the operation, | |
| # this field will be populated. | |
| "errors": [ # [Output Only] The array of errors encountered while processing this | |
| # operation. | |
| { # Represents a single error encountered during the processing of an | |
| # operation. | |
| "code": "A String", # [Output Only] The error type identifier for this error. | |
| "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. | |
| { # Container for structured error details providing additional context | |
| # specific to the encountered error code. | |
| "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata. | |
| # | |
| # Example of an error when contacting the "pubsub.googleapis.com" API when it | |
| # is not enabled: | |
| # | |
| # { "reason": "API_DISABLED" | |
| # "domain": "googleapis.com" | |
| # "metadata": { | |
| # "resource": "projects/123", | |
| # "service": "pubsub.googleapis.com" | |
| # } | |
| # } | |
| # | |
| # This response indicates that the pubsub.googleapis.com API is not enabled. | |
| # | |
| # Example of an error that is returned when attempting to create a Spanner | |
| # instance in a region that is out of stock: | |
| # | |
| # { "reason": "STOCKOUT" | |
| # "domain": "spanner.googleapis.com", | |
| # "metadata": { | |
| # "availableRegions": "us-central1,us-east2" | |
| # } | |
| # } | |
| "domain": "A String", # 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". | |
| "metadatas": { # Additional structured details about this error. | |
| # | |
| # Keys must match a regular expression of `a-z+` but should | |
| # ideally be lowerCamelCase. Also, they must be limited to 64 characters in | |
| # length. When identifying the current value of an exceeded limit, the units | |
| # should be contained in the key, not the value. For example, rather than | |
| # `{"instanceLimit": "100/request"}`, should be returned as, | |
| # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of | |
| # instances that can be created in a single (batch) request. | |
| "a_key": "A String", | |
| }, | |
| "reason": "A String", # 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 `A-Z+[A-Z0-9]`, which represents | |
| # UPPER_SNAKE_CASE. | |
| }, | |
| "help": { # Provides links to documentation or for performing an out of band action. # Links and information to help the user resolve the error. | |
| # | |
| # For example, if a quota check failed with an error indicating the calling | |
| # project hasn't enabled the accessed service, this can contain a URL pointing | |
| # directly to the right place in the developer console to flip the bit. | |
| "links": [ # URL(s) pointing to additional information on handling the current error. | |
| { # Describes a URL link. | |
| "description": "A String", # Describes what the link offers. | |
| "url": "A String", # The URL of the link. | |
| }, | |
| ], | |
| }, | |
| "localizedMessage": { # Provides a localized error message that is safe to return to the user # A localized human-readable error message intended for end users. | |
| # which can be attached to an RPC error. | |
| "locale": "A String", # 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" | |
| "message": "A String", # The localized error message in the above locale. | |
| }, | |
| "quotaInfo": { # Additional details for quota exceeded error for resource quota. # Details about quota limits and metrics when a quota is exceeded. | |
| "dimensions": { # The map holding related quota dimensions. | |
| "a_key": "A String", | |
| }, | |
| "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota | |
| # type or metric. | |
| "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type | |
| # or metric. | |
| "limitName": "A String", # The name of the quota limit. | |
| "metricName": "A String", # The Compute Engine quota metric name. | |
| "rolloutStatus": "A String", # Rollout status of the future quota limit. | |
| }, | |
| }, | |
| ], | |
| "location": "A String", # [Output Only] Indicates the field in the request that caused the error. | |
| # This property is optional. | |
| "message": "A String", # [Output Only] An optional, human-readable error message. | |
| }, | |
| ], | |
| }, | |
| "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations. | |
| "healthInfo": { # Health information. # Output only. The health information. | |
| "availabilitySloStatus": "A String", # Output only. The availability SLO status. | |
| "healthStatus": "A String", # Output only. The health status. | |
| "repairCategory": "A String", # Output only. The repair category. | |
| "unhealthyReason": "A String", # Output only. The reason for unhealthy status. | |
| "updateTime": "A String", # Output only. The time when health info was updated. | |
| }, | |
| }, | |
| "getVersionOperationMetadata": { | |
| "inlineSbomInfo": { | |
| "currentComponentVersions": { # A mapping of components to their currently-applied versions or other | |
| # appropriate identifiers. | |
| "a_key": "A String", | |
| }, | |
| "targetComponentVersions": { # A mapping of components to their target versions or other appropriate | |
| # identifiers. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| }, | |
| "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error | |
| # message that was returned, such as `NOT FOUND`. | |
| "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error | |
| # status code that was returned. For example, a `404` means the | |
| # resource was not found. | |
| "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is | |
| # defined by the server. | |
| "insertTime": "A String", # [Output Only] The time that this operation was requested. | |
| # This value is inRFC3339 | |
| # text format. | |
| "instancesBulkInsertOperationMetadata": { | |
| "perLocationStatus": { # Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far. | |
| "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback. | |
| "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an | |
| # error. | |
| "status": "A String", # [Output Only] Creation status of BulkInsert operation - information | |
| # if the flow is rolling forward or rolling back. | |
| "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created. | |
| }, | |
| }, | |
| }, | |
| "instancesTroubleshootOperationMetadata": { # [Output Only] Operation metadata for instances.troubleshoot. # Output only. [Output Only] Operation metadata for instances.troubleshoot. | |
| "troubleshootOutput": "A String", # Output only. [Output Only] Serialized output of the troubleshooting diagnostic run. | |
| }, | |
| "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for | |
| # Operation resources. | |
| "name": "A String", # [Output Only] Name of the operation. | |
| "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a | |
| # group of operations results from a `bulkInsert` API request. | |
| "operationType": "A String", # [Output Only] The type of operation, such as `insert`, | |
| # `update`, or `delete`, and so on. | |
| "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. | |
| # There is no requirement that this be linear or support any granularity of | |
| # operations. This should not be used to guess when the operation will be | |
| # complete. This number should monotonically increase as the operation | |
| # progresses. | |
| "region": "A String", # [Output Only] The URL of the region where the operation resides. Only | |
| # applicable when performing regional operations. | |
| "selfLink": "A String", # [Output Only] Server-defined URL for the resource. | |
| "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata, | |
| # this field will contain information on all underlying zonal actions and | |
| # their state. | |
| "clientOperationId": "A String", # [Output Only] The client operation id. | |
| "perLocationOperations": { # [Output Only] Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is | |
| # populated. | |
| # different programming environments, including REST APIs and RPC APIs. It is | |
| # used by [gRPC](https://github.com/grpc). Each `Status` message contains | |
| # three pieces of data: error code, error message, and error details. | |
| # | |
| # You can find out more about this error model and how to work with it in the | |
| # [API Design Guide](https://cloud.google.com/apis/design/errors). | |
| "code": 42, # The status code, which should be an enum value of google.rpc.Code. | |
| "details": [ # A list of messages that carry the error details. There is a common set of | |
| # message types for APIs to use. | |
| { | |
| "a_key": "", # Properties of the object. Contains field @type with type URL. | |
| }, | |
| ], | |
| "message": "A String", # A developer-facing error message, which should be in English. Any | |
| # user-facing error message should be localized and sent in the | |
| # google.rpc.Status.details field, or localized by the client. | |
| }, | |
| "state": "A String", # [Output Only] Status of the action, which can be one of the following: | |
| # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. | |
| }, | |
| }, | |
| }, | |
| "startTime": "A String", # [Output Only] The time that this operation was started by the server. | |
| # This value is inRFC3339 | |
| # text format. | |
| "status": "A String", # [Output Only] The status of the operation, which can be one of the | |
| # following: | |
| # `PENDING`, `RUNNING`, or `DONE`. | |
| "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the | |
| # operation. | |
| "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation | |
| # of the target resource. | |
| "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For | |
| # operations related to creating a snapshot, this points to the disk | |
| # that the snapshot was created from. | |
| "user": "A String", # [Output Only] User who requested the operation, for example: | |
| # `user@example.com` or | |
| # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. | |
| "warnings": [ # [Output Only] If warning messages are generated during processing of the | |
| # operation, this field will be populated. | |
| { | |
| "code": "A String", # [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": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A 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": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| ], | |
| "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only | |
| # applicable when performing per-zone operations. | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="close">close()</code> | |
| <pre>Close httplib2 connections.</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="delete">delete(project, zone, futureReservation, requestId=None, x__xgafv=None)</code> | |
| <pre>Deletes the specified future reservation. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| zone: string, Name of the zone for this request. Name should conform to RFC1035. (required) | |
| futureReservation: string, Name of the future reservation to retrieve. Name should conform to RFC1035. (required) | |
| requestId: string, An optional request ID to identify requests. Specify a unique request ID so | |
| that if you must retry your request, the server will know to ignore the | |
| request if it has already been completed. | |
| For example, consider a situation where you make an initial request and | |
| the request times out. If you make the request again with the same | |
| request ID, the server can check if original operation with the same | |
| request ID was received, and if so, will ignore the second request. This | |
| prevents clients from accidentally creating duplicate commitments. | |
| The request ID must be | |
| a valid UUID with the exception that zero UUID is not supported | |
| (00000000-0000-0000-0000-000000000000). | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Represents an Operation resource. | |
| # | |
| # Google Compute Engine has three Operation resources: | |
| # | |
| # * [Global](/compute/docs/reference/rest/v1/globalOperations) | |
| # * [Regional](/compute/docs/reference/rest/v1/regionOperations) | |
| # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) | |
| # | |
| # You can use an operation resource to manage asynchronous API requests. | |
| # For more information, readHandling | |
| # API responses. | |
| # | |
| # Operations can be global, regional or zonal. | |
| # | |
| # - For global operations, use the `globalOperations` | |
| # resource. | |
| # - For regional operations, use the | |
| # `regionOperations` resource. | |
| # - For zonal operations, use | |
| # the `zoneOperations` resource. | |
| # | |
| # | |
| # | |
| # For more information, read | |
| # Global, Regional, and Zonal Resources. | |
| # | |
| # Note that completed Operation resources have a limited | |
| # retention period. | |
| "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. | |
| # Not present otherwise. | |
| "creationTimestamp": "A String", # [Deprecated] This field is deprecated. | |
| "description": "A String", # [Output Only] A textual description of the operation, which is | |
| # set when the operation is created. | |
| "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339 | |
| # text format. | |
| "error": { # [Output Only] If errors are generated during processing of the operation, | |
| # this field will be populated. | |
| "errors": [ # [Output Only] The array of errors encountered while processing this | |
| # operation. | |
| { # Represents a single error encountered during the processing of an | |
| # operation. | |
| "code": "A String", # [Output Only] The error type identifier for this error. | |
| "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. | |
| { # Container for structured error details providing additional context | |
| # specific to the encountered error code. | |
| "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata. | |
| # | |
| # Example of an error when contacting the "pubsub.googleapis.com" API when it | |
| # is not enabled: | |
| # | |
| # { "reason": "API_DISABLED" | |
| # "domain": "googleapis.com" | |
| # "metadata": { | |
| # "resource": "projects/123", | |
| # "service": "pubsub.googleapis.com" | |
| # } | |
| # } | |
| # | |
| # This response indicates that the pubsub.googleapis.com API is not enabled. | |
| # | |
| # Example of an error that is returned when attempting to create a Spanner | |
| # instance in a region that is out of stock: | |
| # | |
| # { "reason": "STOCKOUT" | |
| # "domain": "spanner.googleapis.com", | |
| # "metadata": { | |
| # "availableRegions": "us-central1,us-east2" | |
| # } | |
| # } | |
| "domain": "A String", # 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". | |
| "metadatas": { # Additional structured details about this error. | |
| # | |
| # Keys must match a regular expression of `a-z+` but should | |
| # ideally be lowerCamelCase. Also, they must be limited to 64 characters in | |
| # length. When identifying the current value of an exceeded limit, the units | |
| # should be contained in the key, not the value. For example, rather than | |
| # `{"instanceLimit": "100/request"}`, should be returned as, | |
| # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of | |
| # instances that can be created in a single (batch) request. | |
| "a_key": "A String", | |
| }, | |
| "reason": "A String", # 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 `A-Z+[A-Z0-9]`, which represents | |
| # UPPER_SNAKE_CASE. | |
| }, | |
| "help": { # Provides links to documentation or for performing an out of band action. # Links and information to help the user resolve the error. | |
| # | |
| # For example, if a quota check failed with an error indicating the calling | |
| # project hasn't enabled the accessed service, this can contain a URL pointing | |
| # directly to the right place in the developer console to flip the bit. | |
| "links": [ # URL(s) pointing to additional information on handling the current error. | |
| { # Describes a URL link. | |
| "description": "A String", # Describes what the link offers. | |
| "url": "A String", # The URL of the link. | |
| }, | |
| ], | |
| }, | |
| "localizedMessage": { # Provides a localized error message that is safe to return to the user # A localized human-readable error message intended for end users. | |
| # which can be attached to an RPC error. | |
| "locale": "A String", # 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" | |
| "message": "A String", # The localized error message in the above locale. | |
| }, | |
| "quotaInfo": { # Additional details for quota exceeded error for resource quota. # Details about quota limits and metrics when a quota is exceeded. | |
| "dimensions": { # The map holding related quota dimensions. | |
| "a_key": "A String", | |
| }, | |
| "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota | |
| # type or metric. | |
| "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type | |
| # or metric. | |
| "limitName": "A String", # The name of the quota limit. | |
| "metricName": "A String", # The Compute Engine quota metric name. | |
| "rolloutStatus": "A String", # Rollout status of the future quota limit. | |
| }, | |
| }, | |
| ], | |
| "location": "A String", # [Output Only] Indicates the field in the request that caused the error. | |
| # This property is optional. | |
| "message": "A String", # [Output Only] An optional, human-readable error message. | |
| }, | |
| ], | |
| }, | |
| "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations. | |
| "healthInfo": { # Health information. # Output only. The health information. | |
| "availabilitySloStatus": "A String", # Output only. The availability SLO status. | |
| "healthStatus": "A String", # Output only. The health status. | |
| "repairCategory": "A String", # Output only. The repair category. | |
| "unhealthyReason": "A String", # Output only. The reason for unhealthy status. | |
| "updateTime": "A String", # Output only. The time when health info was updated. | |
| }, | |
| }, | |
| "getVersionOperationMetadata": { | |
| "inlineSbomInfo": { | |
| "currentComponentVersions": { # A mapping of components to their currently-applied versions or other | |
| # appropriate identifiers. | |
| "a_key": "A String", | |
| }, | |
| "targetComponentVersions": { # A mapping of components to their target versions or other appropriate | |
| # identifiers. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| }, | |
| "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error | |
| # message that was returned, such as `NOT FOUND`. | |
| "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error | |
| # status code that was returned. For example, a `404` means the | |
| # resource was not found. | |
| "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is | |
| # defined by the server. | |
| "insertTime": "A String", # [Output Only] The time that this operation was requested. | |
| # This value is inRFC3339 | |
| # text format. | |
| "instancesBulkInsertOperationMetadata": { | |
| "perLocationStatus": { # Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far. | |
| "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback. | |
| "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an | |
| # error. | |
| "status": "A String", # [Output Only] Creation status of BulkInsert operation - information | |
| # if the flow is rolling forward or rolling back. | |
| "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created. | |
| }, | |
| }, | |
| }, | |
| "instancesTroubleshootOperationMetadata": { # [Output Only] Operation metadata for instances.troubleshoot. # Output only. [Output Only] Operation metadata for instances.troubleshoot. | |
| "troubleshootOutput": "A String", # Output only. [Output Only] Serialized output of the troubleshooting diagnostic run. | |
| }, | |
| "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for | |
| # Operation resources. | |
| "name": "A String", # [Output Only] Name of the operation. | |
| "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a | |
| # group of operations results from a `bulkInsert` API request. | |
| "operationType": "A String", # [Output Only] The type of operation, such as `insert`, | |
| # `update`, or `delete`, and so on. | |
| "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. | |
| # There is no requirement that this be linear or support any granularity of | |
| # operations. This should not be used to guess when the operation will be | |
| # complete. This number should monotonically increase as the operation | |
| # progresses. | |
| "region": "A String", # [Output Only] The URL of the region where the operation resides. Only | |
| # applicable when performing regional operations. | |
| "selfLink": "A String", # [Output Only] Server-defined URL for the resource. | |
| "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata, | |
| # this field will contain information on all underlying zonal actions and | |
| # their state. | |
| "clientOperationId": "A String", # [Output Only] The client operation id. | |
| "perLocationOperations": { # [Output Only] Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is | |
| # populated. | |
| # different programming environments, including REST APIs and RPC APIs. It is | |
| # used by [gRPC](https://github.com/grpc). Each `Status` message contains | |
| # three pieces of data: error code, error message, and error details. | |
| # | |
| # You can find out more about this error model and how to work with it in the | |
| # [API Design Guide](https://cloud.google.com/apis/design/errors). | |
| "code": 42, # The status code, which should be an enum value of google.rpc.Code. | |
| "details": [ # A list of messages that carry the error details. There is a common set of | |
| # message types for APIs to use. | |
| { | |
| "a_key": "", # Properties of the object. Contains field @type with type URL. | |
| }, | |
| ], | |
| "message": "A String", # A developer-facing error message, which should be in English. Any | |
| # user-facing error message should be localized and sent in the | |
| # google.rpc.Status.details field, or localized by the client. | |
| }, | |
| "state": "A String", # [Output Only] Status of the action, which can be one of the following: | |
| # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. | |
| }, | |
| }, | |
| }, | |
| "startTime": "A String", # [Output Only] The time that this operation was started by the server. | |
| # This value is inRFC3339 | |
| # text format. | |
| "status": "A String", # [Output Only] The status of the operation, which can be one of the | |
| # following: | |
| # `PENDING`, `RUNNING`, or `DONE`. | |
| "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the | |
| # operation. | |
| "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation | |
| # of the target resource. | |
| "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For | |
| # operations related to creating a snapshot, this points to the disk | |
| # that the snapshot was created from. | |
| "user": "A String", # [Output Only] User who requested the operation, for example: | |
| # `user@example.com` or | |
| # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. | |
| "warnings": [ # [Output Only] If warning messages are generated during processing of the | |
| # operation, this field will be populated. | |
| { | |
| "code": "A String", # [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": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A 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": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| ], | |
| "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only | |
| # applicable when performing per-zone operations. | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="get">get(project, zone, futureReservation, x__xgafv=None)</code> | |
| <pre>Retrieves information about the specified future reservation. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| zone: string, Name of the zone for this request. Name should conform to RFC1035. (required) | |
| futureReservation: string, Name of the future reservation to retrieve. Name should conform to RFC1035. (required) | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { | |
| "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation. | |
| # count of CPUs) and can account for multiple instance SKUs. In other words, | |
| # one can create instances of varying shapes against this reservation. | |
| "inUseResources": [ # Output only. [Output only] List of resources currently in use. | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators). | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must | |
| # belong to. | |
| "workloadType": "A String", # The workload type of the instances that will target this reservation. | |
| }, | |
| "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by | |
| # Compute Engine. Format of this field must be a valid | |
| # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. | |
| "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations. | |
| # It represents relative time to future reservation start_time when | |
| # auto-created reservations will be automatically deleted by Compute | |
| # Engine. Duration time unit is represented as a count of seconds | |
| # and fractions of seconds at nanosecond resolution. | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created | |
| # reservation. If set to true, auto-created reservations will be | |
| # deleted at Future Reservation's end time (default) or at user's defined | |
| # timestamp if any of the | |
| # [auto_created_reservations_delete_time, auto_created_reservations_duration] | |
| # values is specified. | |
| # For keeping auto-created reservation indefinitely, this value should be set | |
| # to false. | |
| "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate | |
| # intent for reserving capacity in the same cluster as the colocation | |
| # resource. | |
| "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an | |
| # existing commitment. | |
| "commitmentName": "A String", # name of the commitment where capacity is being delivered to. | |
| "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If | |
| # this field is not present, then no | |
| # commitment needs to be created. | |
| "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all | |
| # parent commitments will be extended to match the end date of the plan for | |
| # this commitment. | |
| }, | |
| "confidentialComputeType": "A String", | |
| "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339 | |
| # text format. | |
| "deploymentType": "A String", # Type of the deployment requested as part of future reservation. | |
| "description": "A String", # An optional description of this resource. Provide this property when you | |
| # create the future reservation. | |
| "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled. | |
| "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server | |
| # defines this identifier. | |
| "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. | |
| "name": "A String", # The name of the resource, provided by the client when initially creating | |
| # the resource. The resource name must be 1-63 characters long, and comply | |
| # withRFC1035. | |
| # Specifically, the name must be 1-63 characters long and match the regular | |
| # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first | |
| # character must be a lowercase letter, and all following characters must be | |
| # a dash, lowercase letter, or digit, except the last character, which cannot | |
| # be a dash. | |
| "namePrefix": "A String", # Name prefix for the reservations to be created at the time of | |
| # delivery. The name prefix must comply with RFC1035. | |
| # Maximum allowed length for name prefix is 20. Automatically created | |
| # reservations name format will be -date-####. | |
| "params": { # Additional future reservation params. # Input only. Additional params passed with the request, but not persisted | |
| # as part of resource payload. | |
| "resourceManagerTags": { # Input only. Resource manager tags to be bound to the future reservation. Tag keys and | |
| # values have the same definition as resource | |
| # manager tags. Keys and values can be either in numeric format, | |
| # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in | |
| # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and | |
| # `{tag_value_short_name}`. The field is ignored (both PUT & | |
| # PATCH) when empty. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| "planningStatus": "A String", # Planning state before being submitted for evaluation | |
| "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and | |
| # expected pricing. | |
| "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of | |
| # delivery of future reservations. If the reservation with the given name | |
| # does not exist already, it is created automatically at the time of Approval | |
| # with INACTIVE state till specified start-time. Either provide the | |
| # reservation_name or a name_prefix. | |
| "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation | |
| # resource. It is populated for each instance of the FutureReservation | |
| # resource, and includes the api_version the | |
| # instance was retrieved through, and its canonical | |
| # resource_type name. | |
| "apiVersion": "A String", # The version of the API interface that this resource was retrieved through. | |
| # For example, `"2025-01-01"` or `"2025-01-01-preview"`. | |
| "resourceType": "A String", # The canonical resource type name in the format of a resource type | |
| # as defined by [AIP-123](https://google.aip.dev/123). | |
| # For example, `"compute.googleapis.com/Instance"`. | |
| }, | |
| "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to | |
| # RFC1035. This will be the name of storage pool or Exapool for persistent | |
| # disk FRs. | |
| "schedulingType": "A String", # Maintenance information for this reservation | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. | |
| "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with | |
| # affinity for "any" reservation. If the field is set, then only VMs that | |
| # target the reservation by name can consume from the delivered reservation. | |
| "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and | |
| # total count. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation | |
| "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment. | |
| "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at | |
| # start_time. | |
| "A String", | |
| ], | |
| "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future | |
| # reservation. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during | |
| # "PROVISIONING" state. This count also includes capacity delivered as part | |
| # of existing matching reservations. | |
| "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an | |
| # amendment was requested. If the amendment is declined, the Future | |
| # Reservation will be reverted to the last known good state. The last known | |
| # good state is not set when updating a future reservation whose | |
| # Procurement Status is DRAFTING. | |
| # amendment be declined. | |
| "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an | |
| # amendment was requested. | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future | |
| # reservation before an amendment was requested. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the | |
| # Future Reservation. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| }, | |
| "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an | |
| # amendment was requested. | |
| "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an | |
| # amendment was requested. | |
| "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future | |
| # Reservation. | |
| }, | |
| "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no | |
| # modifications to Future Reservation will be allowed. Applicable only | |
| # after the Future Reservation is in the APPROVED state. The lock_time is | |
| # an RFC3339 string. The procurement_status will transition to PROCURING | |
| # state at this time. | |
| "procurementStatus": "A String", # Output only. Current state of this Future Reservation | |
| "specificSkuProperties": { # Properties to be set for the Future Reservation. | |
| "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation | |
| # properties. | |
| }, | |
| "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| }, | |
| "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation. | |
| "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| "storagePoolType": "A String", # Type of the storage pool. | |
| }, | |
| "timeWindow": { # Time window for this Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides. | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</code> | |
| <pre>Creates a new Future Reservation. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| zone: string, Name of the zone for this request. Name should conform to RFC1035. (required) | |
| body: object, The request body. | |
| The object takes the form of: | |
| { | |
| "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation. | |
| # count of CPUs) and can account for multiple instance SKUs. In other words, | |
| # one can create instances of varying shapes against this reservation. | |
| "inUseResources": [ # Output only. [Output only] List of resources currently in use. | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators). | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must | |
| # belong to. | |
| "workloadType": "A String", # The workload type of the instances that will target this reservation. | |
| }, | |
| "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by | |
| # Compute Engine. Format of this field must be a valid | |
| # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. | |
| "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations. | |
| # It represents relative time to future reservation start_time when | |
| # auto-created reservations will be automatically deleted by Compute | |
| # Engine. Duration time unit is represented as a count of seconds | |
| # and fractions of seconds at nanosecond resolution. | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created | |
| # reservation. If set to true, auto-created reservations will be | |
| # deleted at Future Reservation's end time (default) or at user's defined | |
| # timestamp if any of the | |
| # [auto_created_reservations_delete_time, auto_created_reservations_duration] | |
| # values is specified. | |
| # For keeping auto-created reservation indefinitely, this value should be set | |
| # to false. | |
| "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate | |
| # intent for reserving capacity in the same cluster as the colocation | |
| # resource. | |
| "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an | |
| # existing commitment. | |
| "commitmentName": "A String", # name of the commitment where capacity is being delivered to. | |
| "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If | |
| # this field is not present, then no | |
| # commitment needs to be created. | |
| "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all | |
| # parent commitments will be extended to match the end date of the plan for | |
| # this commitment. | |
| }, | |
| "confidentialComputeType": "A String", | |
| "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339 | |
| # text format. | |
| "deploymentType": "A String", # Type of the deployment requested as part of future reservation. | |
| "description": "A String", # An optional description of this resource. Provide this property when you | |
| # create the future reservation. | |
| "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled. | |
| "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server | |
| # defines this identifier. | |
| "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. | |
| "name": "A String", # The name of the resource, provided by the client when initially creating | |
| # the resource. The resource name must be 1-63 characters long, and comply | |
| # withRFC1035. | |
| # Specifically, the name must be 1-63 characters long and match the regular | |
| # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first | |
| # character must be a lowercase letter, and all following characters must be | |
| # a dash, lowercase letter, or digit, except the last character, which cannot | |
| # be a dash. | |
| "namePrefix": "A String", # Name prefix for the reservations to be created at the time of | |
| # delivery. The name prefix must comply with RFC1035. | |
| # Maximum allowed length for name prefix is 20. Automatically created | |
| # reservations name format will be -date-####. | |
| "params": { # Additional future reservation params. # Input only. Additional params passed with the request, but not persisted | |
| # as part of resource payload. | |
| "resourceManagerTags": { # Input only. Resource manager tags to be bound to the future reservation. Tag keys and | |
| # values have the same definition as resource | |
| # manager tags. Keys and values can be either in numeric format, | |
| # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in | |
| # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and | |
| # `{tag_value_short_name}`. The field is ignored (both PUT & | |
| # PATCH) when empty. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| "planningStatus": "A String", # Planning state before being submitted for evaluation | |
| "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and | |
| # expected pricing. | |
| "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of | |
| # delivery of future reservations. If the reservation with the given name | |
| # does not exist already, it is created automatically at the time of Approval | |
| # with INACTIVE state till specified start-time. Either provide the | |
| # reservation_name or a name_prefix. | |
| "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation | |
| # resource. It is populated for each instance of the FutureReservation | |
| # resource, and includes the api_version the | |
| # instance was retrieved through, and its canonical | |
| # resource_type name. | |
| "apiVersion": "A String", # The version of the API interface that this resource was retrieved through. | |
| # For example, `"2025-01-01"` or `"2025-01-01-preview"`. | |
| "resourceType": "A String", # The canonical resource type name in the format of a resource type | |
| # as defined by [AIP-123](https://google.aip.dev/123). | |
| # For example, `"compute.googleapis.com/Instance"`. | |
| }, | |
| "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to | |
| # RFC1035. This will be the name of storage pool or Exapool for persistent | |
| # disk FRs. | |
| "schedulingType": "A String", # Maintenance information for this reservation | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. | |
| "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with | |
| # affinity for "any" reservation. If the field is set, then only VMs that | |
| # target the reservation by name can consume from the delivered reservation. | |
| "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and | |
| # total count. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation | |
| "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment. | |
| "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at | |
| # start_time. | |
| "A String", | |
| ], | |
| "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future | |
| # reservation. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during | |
| # "PROVISIONING" state. This count also includes capacity delivered as part | |
| # of existing matching reservations. | |
| "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an | |
| # amendment was requested. If the amendment is declined, the Future | |
| # Reservation will be reverted to the last known good state. The last known | |
| # good state is not set when updating a future reservation whose | |
| # Procurement Status is DRAFTING. | |
| # amendment be declined. | |
| "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an | |
| # amendment was requested. | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future | |
| # reservation before an amendment was requested. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the | |
| # Future Reservation. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| }, | |
| "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an | |
| # amendment was requested. | |
| "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an | |
| # amendment was requested. | |
| "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future | |
| # Reservation. | |
| }, | |
| "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no | |
| # modifications to Future Reservation will be allowed. Applicable only | |
| # after the Future Reservation is in the APPROVED state. The lock_time is | |
| # an RFC3339 string. The procurement_status will transition to PROCURING | |
| # state at this time. | |
| "procurementStatus": "A String", # Output only. Current state of this Future Reservation | |
| "specificSkuProperties": { # Properties to be set for the Future Reservation. | |
| "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation | |
| # properties. | |
| }, | |
| "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| }, | |
| "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation. | |
| "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| "storagePoolType": "A String", # Type of the storage pool. | |
| }, | |
| "timeWindow": { # Time window for this Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides. | |
| } | |
| requestId: string, An optional request ID to identify requests. Specify a unique request ID so | |
| that if you must retry your request, the server will know to ignore the | |
| request if it has already been completed. | |
| For example, consider a situation where you make an initial request and | |
| the request times out. If you make the request again with the same | |
| request ID, the server can check if original operation with the same | |
| request ID was received, and if so, will ignore the second request. This | |
| prevents clients from accidentally creating duplicate commitments. | |
| The request ID must be | |
| a valid UUID with the exception that zero UUID is not supported | |
| (00000000-0000-0000-0000-000000000000). | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Represents an Operation resource. | |
| # | |
| # Google Compute Engine has three Operation resources: | |
| # | |
| # * [Global](/compute/docs/reference/rest/v1/globalOperations) | |
| # * [Regional](/compute/docs/reference/rest/v1/regionOperations) | |
| # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) | |
| # | |
| # You can use an operation resource to manage asynchronous API requests. | |
| # For more information, readHandling | |
| # API responses. | |
| # | |
| # Operations can be global, regional or zonal. | |
| # | |
| # - For global operations, use the `globalOperations` | |
| # resource. | |
| # - For regional operations, use the | |
| # `regionOperations` resource. | |
| # - For zonal operations, use | |
| # the `zoneOperations` resource. | |
| # | |
| # | |
| # | |
| # For more information, read | |
| # Global, Regional, and Zonal Resources. | |
| # | |
| # Note that completed Operation resources have a limited | |
| # retention period. | |
| "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. | |
| # Not present otherwise. | |
| "creationTimestamp": "A String", # [Deprecated] This field is deprecated. | |
| "description": "A String", # [Output Only] A textual description of the operation, which is | |
| # set when the operation is created. | |
| "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339 | |
| # text format. | |
| "error": { # [Output Only] If errors are generated during processing of the operation, | |
| # this field will be populated. | |
| "errors": [ # [Output Only] The array of errors encountered while processing this | |
| # operation. | |
| { # Represents a single error encountered during the processing of an | |
| # operation. | |
| "code": "A String", # [Output Only] The error type identifier for this error. | |
| "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. | |
| { # Container for structured error details providing additional context | |
| # specific to the encountered error code. | |
| "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata. | |
| # | |
| # Example of an error when contacting the "pubsub.googleapis.com" API when it | |
| # is not enabled: | |
| # | |
| # { "reason": "API_DISABLED" | |
| # "domain": "googleapis.com" | |
| # "metadata": { | |
| # "resource": "projects/123", | |
| # "service": "pubsub.googleapis.com" | |
| # } | |
| # } | |
| # | |
| # This response indicates that the pubsub.googleapis.com API is not enabled. | |
| # | |
| # Example of an error that is returned when attempting to create a Spanner | |
| # instance in a region that is out of stock: | |
| # | |
| # { "reason": "STOCKOUT" | |
| # "domain": "spanner.googleapis.com", | |
| # "metadata": { | |
| # "availableRegions": "us-central1,us-east2" | |
| # } | |
| # } | |
| "domain": "A String", # 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". | |
| "metadatas": { # Additional structured details about this error. | |
| # | |
| # Keys must match a regular expression of `a-z+` but should | |
| # ideally be lowerCamelCase. Also, they must be limited to 64 characters in | |
| # length. When identifying the current value of an exceeded limit, the units | |
| # should be contained in the key, not the value. For example, rather than | |
| # `{"instanceLimit": "100/request"}`, should be returned as, | |
| # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of | |
| # instances that can be created in a single (batch) request. | |
| "a_key": "A String", | |
| }, | |
| "reason": "A String", # 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 `A-Z+[A-Z0-9]`, which represents | |
| # UPPER_SNAKE_CASE. | |
| }, | |
| "help": { # Provides links to documentation or for performing an out of band action. # Links and information to help the user resolve the error. | |
| # | |
| # For example, if a quota check failed with an error indicating the calling | |
| # project hasn't enabled the accessed service, this can contain a URL pointing | |
| # directly to the right place in the developer console to flip the bit. | |
| "links": [ # URL(s) pointing to additional information on handling the current error. | |
| { # Describes a URL link. | |
| "description": "A String", # Describes what the link offers. | |
| "url": "A String", # The URL of the link. | |
| }, | |
| ], | |
| }, | |
| "localizedMessage": { # Provides a localized error message that is safe to return to the user # A localized human-readable error message intended for end users. | |
| # which can be attached to an RPC error. | |
| "locale": "A String", # 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" | |
| "message": "A String", # The localized error message in the above locale. | |
| }, | |
| "quotaInfo": { # Additional details for quota exceeded error for resource quota. # Details about quota limits and metrics when a quota is exceeded. | |
| "dimensions": { # The map holding related quota dimensions. | |
| "a_key": "A String", | |
| }, | |
| "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota | |
| # type or metric. | |
| "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type | |
| # or metric. | |
| "limitName": "A String", # The name of the quota limit. | |
| "metricName": "A String", # The Compute Engine quota metric name. | |
| "rolloutStatus": "A String", # Rollout status of the future quota limit. | |
| }, | |
| }, | |
| ], | |
| "location": "A String", # [Output Only] Indicates the field in the request that caused the error. | |
| # This property is optional. | |
| "message": "A String", # [Output Only] An optional, human-readable error message. | |
| }, | |
| ], | |
| }, | |
| "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations. | |
| "healthInfo": { # Health information. # Output only. The health information. | |
| "availabilitySloStatus": "A String", # Output only. The availability SLO status. | |
| "healthStatus": "A String", # Output only. The health status. | |
| "repairCategory": "A String", # Output only. The repair category. | |
| "unhealthyReason": "A String", # Output only. The reason for unhealthy status. | |
| "updateTime": "A String", # Output only. The time when health info was updated. | |
| }, | |
| }, | |
| "getVersionOperationMetadata": { | |
| "inlineSbomInfo": { | |
| "currentComponentVersions": { # A mapping of components to their currently-applied versions or other | |
| # appropriate identifiers. | |
| "a_key": "A String", | |
| }, | |
| "targetComponentVersions": { # A mapping of components to their target versions or other appropriate | |
| # identifiers. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| }, | |
| "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error | |
| # message that was returned, such as `NOT FOUND`. | |
| "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error | |
| # status code that was returned. For example, a `404` means the | |
| # resource was not found. | |
| "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is | |
| # defined by the server. | |
| "insertTime": "A String", # [Output Only] The time that this operation was requested. | |
| # This value is inRFC3339 | |
| # text format. | |
| "instancesBulkInsertOperationMetadata": { | |
| "perLocationStatus": { # Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far. | |
| "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback. | |
| "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an | |
| # error. | |
| "status": "A String", # [Output Only] Creation status of BulkInsert operation - information | |
| # if the flow is rolling forward or rolling back. | |
| "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created. | |
| }, | |
| }, | |
| }, | |
| "instancesTroubleshootOperationMetadata": { # [Output Only] Operation metadata for instances.troubleshoot. # Output only. [Output Only] Operation metadata for instances.troubleshoot. | |
| "troubleshootOutput": "A String", # Output only. [Output Only] Serialized output of the troubleshooting diagnostic run. | |
| }, | |
| "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for | |
| # Operation resources. | |
| "name": "A String", # [Output Only] Name of the operation. | |
| "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a | |
| # group of operations results from a `bulkInsert` API request. | |
| "operationType": "A String", # [Output Only] The type of operation, such as `insert`, | |
| # `update`, or `delete`, and so on. | |
| "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. | |
| # There is no requirement that this be linear or support any granularity of | |
| # operations. This should not be used to guess when the operation will be | |
| # complete. This number should monotonically increase as the operation | |
| # progresses. | |
| "region": "A String", # [Output Only] The URL of the region where the operation resides. Only | |
| # applicable when performing regional operations. | |
| "selfLink": "A String", # [Output Only] Server-defined URL for the resource. | |
| "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata, | |
| # this field will contain information on all underlying zonal actions and | |
| # their state. | |
| "clientOperationId": "A String", # [Output Only] The client operation id. | |
| "perLocationOperations": { # [Output Only] Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is | |
| # populated. | |
| # different programming environments, including REST APIs and RPC APIs. It is | |
| # used by [gRPC](https://github.com/grpc). Each `Status` message contains | |
| # three pieces of data: error code, error message, and error details. | |
| # | |
| # You can find out more about this error model and how to work with it in the | |
| # [API Design Guide](https://cloud.google.com/apis/design/errors). | |
| "code": 42, # The status code, which should be an enum value of google.rpc.Code. | |
| "details": [ # A list of messages that carry the error details. There is a common set of | |
| # message types for APIs to use. | |
| { | |
| "a_key": "", # Properties of the object. Contains field @type with type URL. | |
| }, | |
| ], | |
| "message": "A String", # A developer-facing error message, which should be in English. Any | |
| # user-facing error message should be localized and sent in the | |
| # google.rpc.Status.details field, or localized by the client. | |
| }, | |
| "state": "A String", # [Output Only] Status of the action, which can be one of the following: | |
| # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. | |
| }, | |
| }, | |
| }, | |
| "startTime": "A String", # [Output Only] The time that this operation was started by the server. | |
| # This value is inRFC3339 | |
| # text format. | |
| "status": "A String", # [Output Only] The status of the operation, which can be one of the | |
| # following: | |
| # `PENDING`, `RUNNING`, or `DONE`. | |
| "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the | |
| # operation. | |
| "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation | |
| # of the target resource. | |
| "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For | |
| # operations related to creating a snapshot, this points to the disk | |
| # that the snapshot was created from. | |
| "user": "A String", # [Output Only] User who requested the operation, for example: | |
| # `user@example.com` or | |
| # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. | |
| "warnings": [ # [Output Only] If warning messages are generated during processing of the | |
| # operation, this field will be populated. | |
| { | |
| "code": "A String", # [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": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A 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": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| ], | |
| "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only | |
| # applicable when performing per-zone operations. | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, x__xgafv=None)</code> | |
| <pre>A list of all the future reservations that have been configured for the | |
| specified project in specified zone. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| zone: string, Name of the zone for this request. Name should conform to RFC1035. (required) | |
| filter: string, A filter expression that filters resources listed in the response. Most | |
| Compute resources support two types of filter expressions: | |
| expressions that support regular expressions and expressions that follow | |
| API improvement proposal AIP-160. | |
| These two types of filter expressions cannot be mixed in one request. | |
| If you want to use AIP-160, your expression must specify the field name, an | |
| operator, and the value that you want to use for filtering. The value | |
| must be a string, a number, or a boolean. The operator | |
| must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. | |
| For example, if you are filtering Compute Engine instances, you can | |
| exclude instances named `example-instance` by specifying | |
| `name != example-instance`. | |
| The `:*` comparison can be used to test whether a key has been defined. | |
| For example, to find all objects with `owner` label use: | |
| ``` | |
| labels.owner:* | |
| ``` | |
| You can also filter nested fields. For example, you could specify | |
| `scheduling.automaticRestart = false` to include instances only | |
| if they are not scheduled for automatic restarts. You can use filtering | |
| on nested fields to filter based onresource labels. | |
| To filter on multiple expressions, provide each separate expression within | |
| parentheses. For example: | |
| ``` | |
| (scheduling.automaticRestart = true) | |
| (cpuPlatform = "Intel Skylake") | |
| ``` | |
| By default, each expression is an `AND` expression. However, you | |
| can include `AND` and `OR` expressions explicitly. | |
| For example: | |
| ``` | |
| (cpuPlatform = "Intel Skylake") OR | |
| (cpuPlatform = "Intel Broadwell") AND | |
| (scheduling.automaticRestart = true) | |
| ``` | |
| If you want to use a regular expression, use the `eq` (equal) or `ne` | |
| (not equal) operator against a single un-parenthesized expression with or | |
| without quotes or against multiple parenthesized expressions. Examples: | |
| `fieldname eq unquoted literal` | |
| `fieldname eq 'single quoted literal'` | |
| `fieldname eq "double quoted literal"` | |
| `(fieldname1 eq literal) (fieldname2 ne "literal")` | |
| The literal value is interpreted as a regular expression using GoogleRE2 library syntax. | |
| The literal value must match the entire field. | |
| For example, to filter for instances that do not end with name "instance", | |
| you would use `name ne .*instance`. | |
| You cannot combine constraints on multiple fields using regular | |
| expressions. | |
| maxResults: integer, The maximum number of results per page that should be returned. | |
| If the number of available results is larger than `maxResults`, | |
| Compute Engine returns a `nextPageToken` that can be used to get | |
| the next page of results in subsequent list requests. Acceptable values are | |
| `0` to `500`, inclusive. (Default: `500`) | |
| orderBy: string, Sorts list results by a certain order. By default, results | |
| are returned in alphanumerical order based on the resource name. | |
| You can also sort results in descending order based on the creation | |
| timestamp using `orderBy="creationTimestamp desc"`. This sorts | |
| results based on the `creationTimestamp` field in | |
| reverse chronological order (newest result first). Use this to sort | |
| resources like operations so that the newest operation is returned first. | |
| Currently, only sorting by `name` or | |
| `creationTimestamp desc` is supported. | |
| pageToken: string, Specifies a page token to use. Set `pageToken` to the | |
| `nextPageToken` returned by a previous list request to get | |
| the next page of results. | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { | |
| "etag": "A String", | |
| "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is | |
| # defined by the server. | |
| "items": [ # [Output Only] A list of future reservation resources. | |
| { | |
| "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation. | |
| # count of CPUs) and can account for multiple instance SKUs. In other words, | |
| # one can create instances of varying shapes against this reservation. | |
| "inUseResources": [ # Output only. [Output only] List of resources currently in use. | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators). | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must | |
| # belong to. | |
| "workloadType": "A String", # The workload type of the instances that will target this reservation. | |
| }, | |
| "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by | |
| # Compute Engine. Format of this field must be a valid | |
| # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. | |
| "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations. | |
| # It represents relative time to future reservation start_time when | |
| # auto-created reservations will be automatically deleted by Compute | |
| # Engine. Duration time unit is represented as a count of seconds | |
| # and fractions of seconds at nanosecond resolution. | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created | |
| # reservation. If set to true, auto-created reservations will be | |
| # deleted at Future Reservation's end time (default) or at user's defined | |
| # timestamp if any of the | |
| # [auto_created_reservations_delete_time, auto_created_reservations_duration] | |
| # values is specified. | |
| # For keeping auto-created reservation indefinitely, this value should be set | |
| # to false. | |
| "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate | |
| # intent for reserving capacity in the same cluster as the colocation | |
| # resource. | |
| "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an | |
| # existing commitment. | |
| "commitmentName": "A String", # name of the commitment where capacity is being delivered to. | |
| "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If | |
| # this field is not present, then no | |
| # commitment needs to be created. | |
| "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all | |
| # parent commitments will be extended to match the end date of the plan for | |
| # this commitment. | |
| }, | |
| "confidentialComputeType": "A String", | |
| "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339 | |
| # text format. | |
| "deploymentType": "A String", # Type of the deployment requested as part of future reservation. | |
| "description": "A String", # An optional description of this resource. Provide this property when you | |
| # create the future reservation. | |
| "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled. | |
| "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server | |
| # defines this identifier. | |
| "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. | |
| "name": "A String", # The name of the resource, provided by the client when initially creating | |
| # the resource. The resource name must be 1-63 characters long, and comply | |
| # withRFC1035. | |
| # Specifically, the name must be 1-63 characters long and match the regular | |
| # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first | |
| # character must be a lowercase letter, and all following characters must be | |
| # a dash, lowercase letter, or digit, except the last character, which cannot | |
| # be a dash. | |
| "namePrefix": "A String", # Name prefix for the reservations to be created at the time of | |
| # delivery. The name prefix must comply with RFC1035. | |
| # Maximum allowed length for name prefix is 20. Automatically created | |
| # reservations name format will be -date-####. | |
| "params": { # Additional future reservation params. # Input only. Additional params passed with the request, but not persisted | |
| # as part of resource payload. | |
| "resourceManagerTags": { # Input only. Resource manager tags to be bound to the future reservation. Tag keys and | |
| # values have the same definition as resource | |
| # manager tags. Keys and values can be either in numeric format, | |
| # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in | |
| # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and | |
| # `{tag_value_short_name}`. The field is ignored (both PUT & | |
| # PATCH) when empty. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| "planningStatus": "A String", # Planning state before being submitted for evaluation | |
| "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and | |
| # expected pricing. | |
| "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of | |
| # delivery of future reservations. If the reservation with the given name | |
| # does not exist already, it is created automatically at the time of Approval | |
| # with INACTIVE state till specified start-time. Either provide the | |
| # reservation_name or a name_prefix. | |
| "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation | |
| # resource. It is populated for each instance of the FutureReservation | |
| # resource, and includes the api_version the | |
| # instance was retrieved through, and its canonical | |
| # resource_type name. | |
| "apiVersion": "A String", # The version of the API interface that this resource was retrieved through. | |
| # For example, `"2025-01-01"` or `"2025-01-01-preview"`. | |
| "resourceType": "A String", # The canonical resource type name in the format of a resource type | |
| # as defined by [AIP-123](https://google.aip.dev/123). | |
| # For example, `"compute.googleapis.com/Instance"`. | |
| }, | |
| "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to | |
| # RFC1035. This will be the name of storage pool or Exapool for persistent | |
| # disk FRs. | |
| "schedulingType": "A String", # Maintenance information for this reservation | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. | |
| "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with | |
| # affinity for "any" reservation. If the field is set, then only VMs that | |
| # target the reservation by name can consume from the delivered reservation. | |
| "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and | |
| # total count. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation | |
| "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment. | |
| "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at | |
| # start_time. | |
| "A String", | |
| ], | |
| "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future | |
| # reservation. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during | |
| # "PROVISIONING" state. This count also includes capacity delivered as part | |
| # of existing matching reservations. | |
| "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an | |
| # amendment was requested. If the amendment is declined, the Future | |
| # Reservation will be reverted to the last known good state. The last known | |
| # good state is not set when updating a future reservation whose | |
| # Procurement Status is DRAFTING. | |
| # amendment be declined. | |
| "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an | |
| # amendment was requested. | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future | |
| # reservation before an amendment was requested. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the | |
| # Future Reservation. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| }, | |
| "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an | |
| # amendment was requested. | |
| "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an | |
| # amendment was requested. | |
| "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future | |
| # Reservation. | |
| }, | |
| "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no | |
| # modifications to Future Reservation will be allowed. Applicable only | |
| # after the Future Reservation is in the APPROVED state. The lock_time is | |
| # an RFC3339 string. The procurement_status will transition to PROCURING | |
| # state at this time. | |
| "procurementStatus": "A String", # Output only. Current state of this Future Reservation | |
| "specificSkuProperties": { # Properties to be set for the Future Reservation. | |
| "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation | |
| # properties. | |
| }, | |
| "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| }, | |
| "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation. | |
| "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| "storagePoolType": "A String", # Type of the storage pool. | |
| }, | |
| "timeWindow": { # Time window for this Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides. | |
| }, | |
| ], | |
| "kind": "compute#futureReservationsListResponse", # Output only. [Output Only] Type of resource.Alwayscompute#FutureReservationsListResponse for lists of | |
| # reservations | |
| "nextPageToken": "A String", # [Output Only] 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": "A String", # Output only. [Output Only] Server-defined URL for this resource. | |
| "unreachables": [ # Output only. [Output Only] Unreachable resources. | |
| "A String", | |
| ], | |
| "warning": { # [Output Only] Informational warning message. | |
| "code": "A String", # [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": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A 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": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="list_next">list_next(previous_request, previous_response)</code> | |
| <pre>Retrieves the next page of results. | |
| Args: | |
| previous_request: The request for the previous page. (required) | |
| previous_response: The response from the request for the previous page. (required) | |
| Returns: | |
| A request object that you can call 'execute()' on to request the next | |
| page. Returns None if there are no more items in the collection. | |
| </pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="update">update(project, zone, futureReservation, body=None, requestId=None, updateMask=None, x__xgafv=None)</code> | |
| <pre>Updates the specified future reservation. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| zone: string, Name of the zone for this request. Name should conform to RFC1035. (required) | |
| futureReservation: string, Name of the reservation to update. Name should conform to RFC1035. (required) | |
| body: object, The request body. | |
| The object takes the form of: | |
| { | |
| "aggregateReservation": { # This reservation type is specified by total resource amounts (e.g. total # Aggregate reservation details for the future reservation. | |
| # count of CPUs) and can account for multiple instance SKUs. In other words, | |
| # one can create instances of varying shapes against this reservation. | |
| "inUseResources": [ # Output only. [Output only] List of resources currently in use. | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "reservedResources": [ # List of reserved resources (CPUs, memory, accelerators). | |
| { | |
| "accelerator": { # Properties of accelerator resources in this reservation. | |
| "acceleratorCount": 42, # Number of accelerators of specified type. | |
| "acceleratorType": "A String", # Full or partial URL to accelerator type. e.g. | |
| # "projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l" | |
| }, | |
| }, | |
| ], | |
| "vmFamily": "A String", # The VM family that all instances scheduled against this reservation must | |
| # belong to. | |
| "workloadType": "A String", # The workload type of the instances that will target this reservation. | |
| }, | |
| "autoCreatedReservationsDeleteTime": "A String", # Future timestamp when the FR auto-created reservations will be deleted by | |
| # Compute Engine. Format of this field must be a valid | |
| # href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. | |
| "autoCreatedReservationsDuration": { # A Duration represents a fixed-length span of time represented # Specifies the duration of auto-created reservations. | |
| # It represents relative time to future reservation start_time when | |
| # auto-created reservations will be automatically deleted by Compute | |
| # Engine. Duration time unit is represented as a count of seconds | |
| # and fractions of seconds at nanosecond resolution. | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "autoDeleteAutoCreatedReservations": True or False, # Setting for enabling or disabling automatic deletion for auto-created | |
| # reservation. If set to true, auto-created reservations will be | |
| # deleted at Future Reservation's end time (default) or at user's defined | |
| # timestamp if any of the | |
| # [auto_created_reservations_delete_time, auto_created_reservations_duration] | |
| # values is specified. | |
| # For keeping auto-created reservation indefinitely, this value should be set | |
| # to false. | |
| "colocationResource": "A String", # Full or partial URL of an existing future reservation to indicate | |
| # intent for reserving capacity in the same cluster as the colocation | |
| # resource. | |
| "commitmentInfo": { # If not present, then FR will not deliver a new commitment or update an | |
| # existing commitment. | |
| "commitmentName": "A String", # name of the commitment where capacity is being delivered to. | |
| "commitmentPlan": "A String", # Indicates if a Commitment needs to be created as part of FR delivery. If | |
| # this field is not present, then no | |
| # commitment needs to be created. | |
| "previousCommitmentTerms": "A String", # Only applicable if FR is delivering to the same reservation. If set, all | |
| # parent commitments will be extended to match the end date of the plan for | |
| # this commitment. | |
| }, | |
| "confidentialComputeType": "A String", | |
| "creationTimestamp": "A String", # Output only. [Output Only] The creation timestamp for this future reservation inRFC3339 | |
| # text format. | |
| "deploymentType": "A String", # Type of the deployment requested as part of future reservation. | |
| "description": "A String", # An optional description of this resource. Provide this property when you | |
| # create the future reservation. | |
| "enableEmergentMaintenance": True or False, # Indicates if this group of VMs have emergent maintenance enabled. | |
| "id": "A String", # Output only. [Output Only] A unique identifier for this future reservation. The server | |
| # defines this identifier. | |
| "kind": "compute#futureReservation", # Output only. [Output Only] Type of the resource. Alwayscompute#futureReservation for future reservations. | |
| "name": "A String", # The name of the resource, provided by the client when initially creating | |
| # the resource. The resource name must be 1-63 characters long, and comply | |
| # withRFC1035. | |
| # Specifically, the name must be 1-63 characters long and match the regular | |
| # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first | |
| # character must be a lowercase letter, and all following characters must be | |
| # a dash, lowercase letter, or digit, except the last character, which cannot | |
| # be a dash. | |
| "namePrefix": "A String", # Name prefix for the reservations to be created at the time of | |
| # delivery. The name prefix must comply with RFC1035. | |
| # Maximum allowed length for name prefix is 20. Automatically created | |
| # reservations name format will be -date-####. | |
| "params": { # Additional future reservation params. # Input only. Additional params passed with the request, but not persisted | |
| # as part of resource payload. | |
| "resourceManagerTags": { # Input only. Resource manager tags to be bound to the future reservation. Tag keys and | |
| # values have the same definition as resource | |
| # manager tags. Keys and values can be either in numeric format, | |
| # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in | |
| # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and | |
| # `{tag_value_short_name}`. The field is ignored (both PUT & | |
| # PATCH) when empty. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| "planningStatus": "A String", # Planning state before being submitted for evaluation | |
| "reservationMode": "A String", # The reservation mode which determines reservation-termination behavior and | |
| # expected pricing. | |
| "reservationName": "A String", # Name of reservations where the capacity is provisioned at the time of | |
| # delivery of future reservations. If the reservation with the given name | |
| # does not exist already, it is created automatically at the time of Approval | |
| # with INACTIVE state till specified start-time. Either provide the | |
| # reservation_name or a name_prefix. | |
| "resourceMetadata": { # Standardized resource metadata common to all compute resources. # Output only. Contains standard resource metadata for an FutureReservation | |
| # resource. It is populated for each instance of the FutureReservation | |
| # resource, and includes the api_version the | |
| # instance was retrieved through, and its canonical | |
| # resource_type name. | |
| "apiVersion": "A String", # The version of the API interface that this resource was retrieved through. | |
| # For example, `"2025-01-01"` or `"2025-01-01-preview"`. | |
| "resourceType": "A String", # The canonical resource type name in the format of a resource type | |
| # as defined by [AIP-123](https://google.aip.dev/123). | |
| # For example, `"compute.googleapis.com/Instance"`. | |
| }, | |
| "resourceName": "A String", # Name of the resource intended to be delivered. Name should conform to | |
| # RFC1035. This will be the name of storage pool or Exapool for persistent | |
| # disk FRs. | |
| "schedulingType": "A String", # Maintenance information for this reservation | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined fully-qualified URL for this resource. | |
| "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # List of Projects/Folders to share with. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificReservationRequired": True or False, # Indicates whether the auto-created reservation can be consumed by VMs with | |
| # affinity for "any" reservation. If the field is set, then only VMs that | |
| # target the reservation by name can consume from the delivered reservation. | |
| "specificSkuProperties": { # Future Reservation configuration to indicate instance properties and | |
| # total count. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "status": { # [Output only] Represents status related to the future reservation. # Output only. [Output only] Status of the Future Reservation | |
| "amendmentStatus": "A String", # Output only. [Output Only] The current status of the requested amendment. | |
| "autoCreatedReservations": [ # Output only. Fully qualified urls of the automatically created reservations at | |
| # start_time. | |
| "A String", | |
| ], | |
| "exapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Output only. Exapool provisioned capacities for each SKU type. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the existing matching usage for the future | |
| # reservation. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "fulfilledCount": "A String", # Output only. This count indicates the fulfilled capacity so far. This is set during | |
| # "PROVISIONING" state. This count also includes capacity delivered as part | |
| # of existing matching reservations. | |
| "lastKnownGoodState": { # The state that the future reservation will be reverted to should the # Output only. [Output Only] This field represents the future reservation before an | |
| # amendment was requested. If the amendment is declined, the Future | |
| # Reservation will be reverted to the last known good state. The last known | |
| # good state is not set when updating a future reservation whose | |
| # Procurement Status is DRAFTING. | |
| # amendment be declined. | |
| "description": "A String", # Output only. [Output Only] The description of the FutureReservation before an | |
| # amendment was requested. | |
| "existingMatchingUsageInfo": { # [Output Only] Represents the existing matching usage for the future # Output only. [Output Only] Represents the matching usage for the future | |
| # reservation before an amendment was requested. | |
| # reservation. | |
| "count": "A String", # Output only. Count to represent min(FR total_count, | |
| # matching_reserved_capacity+matching_unreserved_instances) | |
| "timestamp": "A String", # Output only. Timestamp when the matching usage was calculated | |
| }, | |
| "futureReservationSpecs": { # The properties of the last known good state for the Future Reservation. | |
| "shareSettings": { # The share setting for reservations and sole tenancy node groups. # Output only. [Output Only] The previous share settings of the Future Reservation. | |
| "projectMap": { # A map of project id and project config. This is only valid when | |
| # share_type's value is SPECIFIC_PROJECTS. | |
| "a_key": { # Config for each project in the share settings. | |
| "projectId": "A String", # The project ID, should be same as the key of this project config in the | |
| # parent map. | |
| }, | |
| }, | |
| "shareType": "A String", # Type of sharing for this shared-reservation | |
| }, | |
| "specificSkuProperties": { # Output only. [Output Only] The previous instance related properties of the | |
| # Future Reservation. | |
| "instanceProperties": { # Properties of the SKU instances being reserved. # Properties of the SKU instances being reserved. | |
| # Next ID: 10 | |
| "guestAccelerators": [ # Specifies accelerator type and count. | |
| { # A specification of the type and number of accelerator cards attached to the | |
| # instance. | |
| "acceleratorCount": 42, # The number of the guest accelerator cards exposed to this instance. | |
| "acceleratorType": "A String", # Full or partial URL of the accelerator type resource to attach to this | |
| # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 | |
| # If you are creating an instance template, specify only the | |
| # accelerator name. | |
| # See GPUs on Compute Engine | |
| # for a full list of accelerator types. | |
| }, | |
| ], | |
| "localSsds": [ # Specifies amount of local ssd to reserve with each instance. The type | |
| # of disk is local-ssd. | |
| { | |
| "diskSizeGb": "A String", # Specifies the size of the disk in base-2 GB. | |
| "interface": "A String", # Specifies the disk interface to use for attaching this disk, which is | |
| # either SCSI or NVME. The default isSCSI. | |
| # For performance characteristics of SCSI over NVMe, seeLocal SSD performance. | |
| }, | |
| ], | |
| "locationHint": "A String", # An opaque location hint used to place the allocation close to other | |
| # resources. | |
| # This field is for use by internal tools that use the public API. | |
| "machineType": "A String", # Specifies type of machine (name only) which has fixed number of vCPUs | |
| # and fixed amount of memory. This also includes specifying custom | |
| # machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. | |
| "minCpuPlatform": "A String", # Minimum cpu platform the reservation. | |
| }, | |
| "sourceInstanceTemplate": "A String", # The instance template that will be used to populate the | |
| # ReservedInstanceProperties of the future reservation | |
| "totalCount": "A String", # Total number of instances for which capacity assurance is requested at a | |
| # future time period. | |
| }, | |
| "timeWindow": { # Output only. [Output Only] The previous time window of the Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| }, | |
| "lockTime": "A String", # Output only. [Output Only] The lock time of the FutureReservation before an | |
| # amendment was requested. | |
| "namePrefix": "A String", # Output only. [Output Only] The name prefix of the Future Reservation before an | |
| # amendment was requested. | |
| "procurementStatus": "A String", # Output only. [Output Only] The status of the last known good state for the Future | |
| # Reservation. | |
| }, | |
| "lockTime": "A String", # Output only. Time when Future Reservation would become LOCKED, after which no | |
| # modifications to Future Reservation will be allowed. Applicable only | |
| # after the Future Reservation is in the APPROVED state. The lock_time is | |
| # an RFC3339 string. The procurement_status will transition to PROCURING | |
| # state at this time. | |
| "procurementStatus": "A String", # Output only. Current state of this Future Reservation | |
| "specificSkuProperties": { # Properties to be set for the Future Reservation. | |
| "sourceInstanceTemplateId": "A String", # ID of the instance template used to populate the Future Reservation | |
| # properties. | |
| }, | |
| "storagePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Output only. Storage pool provisioned capacities for each SKU type. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| }, | |
| "storagePoolProperties": { # Storage pool properties for the future reservation. # Storage pool details for the future reservation. | |
| "requestedExapoolProvisionedCapacityGb": { # Exapool provisioned capacities for each SKU type # Requested exapool provisioned capacity in GiB. | |
| "capacityOptimized": "A String", # Size, in GiB, of provisioned capacity-optimized capacity for this Exapool | |
| "readOptimized": "A String", # Size, in GiB, of provisioned read-optimized capacity for this Exapool | |
| "writeOptimized": "A String", # Size, in GiB, of provisioned write-optimized capacity for this Exapool | |
| }, | |
| "requestedStoragePoolProvisionedCapacity": { # Storage pool provisioned capacities for each SKU type. # Requested storage pool provisioned capacity. | |
| "poolProvisionedCapacityGb": "A String", # Size of the storage pool in GiB. | |
| "poolProvisionedIops": "A String", # Provisioned IOPS of the storage pool. Only relevant if the storage pool | |
| # type is hyperdisk-balanced. | |
| "poolProvisionedThroughput": "A String", # Provisioned throughput of the storage pool in MiB/s. Only relevant if | |
| # the storage pool type is hyperdisk-balanced or hyperdisk-throughput. | |
| }, | |
| "storagePoolType": "A String", # Type of the storage pool. | |
| }, | |
| "timeWindow": { # Time window for this Future Reservation. | |
| "duration": { # A Duration represents a fixed-length span of time represented | |
| # as a count of seconds and fractions of seconds at nanosecond | |
| # resolution. It is independent of any calendar and concepts like "day" | |
| # or "month". Range is approximately 10,000 years. | |
| "nanos": 42, # Span of time that's a fraction of a second at nanosecond resolution. | |
| # Durations less than one second are represented with a 0 | |
| # `seconds` field and a positive `nanos` field. Must be from 0 | |
| # to 999,999,999 inclusive. | |
| "seconds": "A String", # 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 | |
| }, | |
| "endTime": "A String", | |
| "startTime": "A String", # Start time of the Future Reservation. The start_time is an RFC3339 | |
| # string. | |
| }, | |
| "zone": "A String", # Output only. [Output Only] URL of the Zone where this future reservation resides. | |
| } | |
| requestId: string, An optional request ID to identify requests. Specify a unique request ID so | |
| that if you must retry your request, the server will know to ignore the | |
| request if it has already been completed. | |
| For example, consider a situation where you make an initial request and | |
| the request times out. If you make the request again with the same | |
| request ID, the server can check if original operation with the same | |
| request ID was received, and if so, will ignore the second request. This | |
| prevents clients from accidentally creating duplicate commitments. | |
| The request ID must be | |
| a valid UUID with the exception that zero UUID is not supported | |
| (00000000-0000-0000-0000-000000000000). | |
| updateMask: string, update_mask indicates fields to be updated as part of this request. | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Represents an Operation resource. | |
| # | |
| # Google Compute Engine has three Operation resources: | |
| # | |
| # * [Global](/compute/docs/reference/rest/v1/globalOperations) | |
| # * [Regional](/compute/docs/reference/rest/v1/regionOperations) | |
| # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) | |
| # | |
| # You can use an operation resource to manage asynchronous API requests. | |
| # For more information, readHandling | |
| # API responses. | |
| # | |
| # Operations can be global, regional or zonal. | |
| # | |
| # - For global operations, use the `globalOperations` | |
| # resource. | |
| # - For regional operations, use the | |
| # `regionOperations` resource. | |
| # - For zonal operations, use | |
| # the `zoneOperations` resource. | |
| # | |
| # | |
| # | |
| # For more information, read | |
| # Global, Regional, and Zonal Resources. | |
| # | |
| # Note that completed Operation resources have a limited | |
| # retention period. | |
| "clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. | |
| # Not present otherwise. | |
| "creationTimestamp": "A String", # [Deprecated] This field is deprecated. | |
| "description": "A String", # [Output Only] A textual description of the operation, which is | |
| # set when the operation is created. | |
| "endTime": "A String", # [Output Only] The time that this operation was completed. This value is inRFC3339 | |
| # text format. | |
| "error": { # [Output Only] If errors are generated during processing of the operation, | |
| # this field will be populated. | |
| "errors": [ # [Output Only] The array of errors encountered while processing this | |
| # operation. | |
| { # Represents a single error encountered during the processing of an | |
| # operation. | |
| "code": "A String", # [Output Only] The error type identifier for this error. | |
| "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. | |
| { # Container for structured error details providing additional context | |
| # specific to the encountered error code. | |
| "errorInfo": { # Describes the cause of the error with structured details. # Error information containing structured domain, reason, and metadata. | |
| # | |
| # Example of an error when contacting the "pubsub.googleapis.com" API when it | |
| # is not enabled: | |
| # | |
| # { "reason": "API_DISABLED" | |
| # "domain": "googleapis.com" | |
| # "metadata": { | |
| # "resource": "projects/123", | |
| # "service": "pubsub.googleapis.com" | |
| # } | |
| # } | |
| # | |
| # This response indicates that the pubsub.googleapis.com API is not enabled. | |
| # | |
| # Example of an error that is returned when attempting to create a Spanner | |
| # instance in a region that is out of stock: | |
| # | |
| # { "reason": "STOCKOUT" | |
| # "domain": "spanner.googleapis.com", | |
| # "metadata": { | |
| # "availableRegions": "us-central1,us-east2" | |
| # } | |
| # } | |
| "domain": "A String", # 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". | |
| "metadatas": { # Additional structured details about this error. | |
| # | |
| # Keys must match a regular expression of `a-z+` but should | |
| # ideally be lowerCamelCase. Also, they must be limited to 64 characters in | |
| # length. When identifying the current value of an exceeded limit, the units | |
| # should be contained in the key, not the value. For example, rather than | |
| # `{"instanceLimit": "100/request"}`, should be returned as, | |
| # `{"instanceLimitPerRequest": "100"}`, if the client exceeds the number of | |
| # instances that can be created in a single (batch) request. | |
| "a_key": "A String", | |
| }, | |
| "reason": "A String", # 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 `A-Z+[A-Z0-9]`, which represents | |
| # UPPER_SNAKE_CASE. | |
| }, | |
| "help": { # Provides links to documentation or for performing an out of band action. # Links and information to help the user resolve the error. | |
| # | |
| # For example, if a quota check failed with an error indicating the calling | |
| # project hasn't enabled the accessed service, this can contain a URL pointing | |
| # directly to the right place in the developer console to flip the bit. | |
| "links": [ # URL(s) pointing to additional information on handling the current error. | |
| { # Describes a URL link. | |
| "description": "A String", # Describes what the link offers. | |
| "url": "A String", # The URL of the link. | |
| }, | |
| ], | |
| }, | |
| "localizedMessage": { # Provides a localized error message that is safe to return to the user # A localized human-readable error message intended for end users. | |
| # which can be attached to an RPC error. | |
| "locale": "A String", # 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" | |
| "message": "A String", # The localized error message in the above locale. | |
| }, | |
| "quotaInfo": { # Additional details for quota exceeded error for resource quota. # Details about quota limits and metrics when a quota is exceeded. | |
| "dimensions": { # The map holding related quota dimensions. | |
| "a_key": "A String", | |
| }, | |
| "futureLimit": 3.14, # Future quota limit being rolled out. The limit's unit depends on the quota | |
| # type or metric. | |
| "limit": 3.14, # Current effective quota limit. The limit's unit depends on the quota type | |
| # or metric. | |
| "limitName": "A String", # The name of the quota limit. | |
| "metricName": "A String", # The Compute Engine quota metric name. | |
| "rolloutStatus": "A String", # Rollout status of the future quota limit. | |
| }, | |
| }, | |
| ], | |
| "location": "A String", # [Output Only] Indicates the field in the request that caused the error. | |
| # This property is optional. | |
| "message": "A String", # [Output Only] An optional, human-readable error message. | |
| }, | |
| ], | |
| }, | |
| "getHealthOperationMetadata": { # Metadata for GetHealth operations. # Output only. Metadata for GetHealth operations. | |
| "healthInfo": { # Health information. # Output only. The health information. | |
| "availabilitySloStatus": "A String", # Output only. The availability SLO status. | |
| "healthStatus": "A String", # Output only. The health status. | |
| "repairCategory": "A String", # Output only. The repair category. | |
| "unhealthyReason": "A String", # Output only. The reason for unhealthy status. | |
| "updateTime": "A String", # Output only. The time when health info was updated. | |
| }, | |
| }, | |
| "getVersionOperationMetadata": { | |
| "inlineSbomInfo": { | |
| "currentComponentVersions": { # A mapping of components to their currently-applied versions or other | |
| # appropriate identifiers. | |
| "a_key": "A String", | |
| }, | |
| "targetComponentVersions": { # A mapping of components to their target versions or other appropriate | |
| # identifiers. | |
| "a_key": "A String", | |
| }, | |
| }, | |
| }, | |
| "httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error | |
| # message that was returned, such as `NOT FOUND`. | |
| "httpErrorStatusCode": 42, # [Output Only] If the operation fails, this field contains the HTTP error | |
| # status code that was returned. For example, a `404` means the | |
| # resource was not found. | |
| "id": "A String", # [Output Only] The unique identifier for the operation. This identifier is | |
| # defined by the server. | |
| "insertTime": "A String", # [Output Only] The time that this operation was requested. | |
| # This value is inRFC3339 | |
| # text format. | |
| "instancesBulkInsertOperationMetadata": { | |
| "perLocationStatus": { # Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "createdVmCount": 42, # [Output Only] Count of VMs successfully created so far. | |
| "deletedVmCount": 42, # [Output Only] Count of VMs that got deleted during rollback. | |
| "failedToCreateVmCount": 42, # [Output Only] Count of VMs that started creating but encountered an | |
| # error. | |
| "status": "A String", # [Output Only] Creation status of BulkInsert operation - information | |
| # if the flow is rolling forward or rolling back. | |
| "targetVmCount": 42, # [Output Only] Count of VMs originally planned to be created. | |
| }, | |
| }, | |
| }, | |
| "instancesTroubleshootOperationMetadata": { # [Output Only] Operation metadata for instances.troubleshoot. # Output only. [Output Only] Operation metadata for instances.troubleshoot. | |
| "troubleshootOutput": "A String", # Output only. [Output Only] Serialized output of the troubleshooting diagnostic run. | |
| }, | |
| "kind": "compute#operation", # Output only. [Output Only] Type of the resource. Always `compute#operation` for | |
| # Operation resources. | |
| "name": "A String", # [Output Only] Name of the operation. | |
| "operationGroupId": "A String", # Output only. [Output Only] An ID that represents a group of operations, such as when a | |
| # group of operations results from a `bulkInsert` API request. | |
| "operationType": "A String", # [Output Only] The type of operation, such as `insert`, | |
| # `update`, or `delete`, and so on. | |
| "progress": 42, # [Output Only] An optional progress indicator that ranges from 0 to 100. | |
| # There is no requirement that this be linear or support any granularity of | |
| # operations. This should not be used to guess when the operation will be | |
| # complete. This number should monotonically increase as the operation | |
| # progresses. | |
| "region": "A String", # [Output Only] The URL of the region where the operation resides. Only | |
| # applicable when performing regional operations. | |
| "selfLink": "A String", # [Output Only] Server-defined URL for the resource. | |
| "setCommonInstanceMetadataOperationMetadata": { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata, | |
| # this field will contain information on all underlying zonal actions and | |
| # their state. | |
| "clientOperationId": "A String", # [Output Only] The client operation id. | |
| "perLocationOperations": { # [Output Only] Status information per location (location name is key). | |
| # Example key: zones/us-central1-a | |
| "a_key": { | |
| "error": { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is | |
| # populated. | |
| # different programming environments, including REST APIs and RPC APIs. It is | |
| # used by [gRPC](https://github.com/grpc). Each `Status` message contains | |
| # three pieces of data: error code, error message, and error details. | |
| # | |
| # You can find out more about this error model and how to work with it in the | |
| # [API Design Guide](https://cloud.google.com/apis/design/errors). | |
| "code": 42, # The status code, which should be an enum value of google.rpc.Code. | |
| "details": [ # A list of messages that carry the error details. There is a common set of | |
| # message types for APIs to use. | |
| { | |
| "a_key": "", # Properties of the object. Contains field @type with type URL. | |
| }, | |
| ], | |
| "message": "A String", # A developer-facing error message, which should be in English. Any | |
| # user-facing error message should be localized and sent in the | |
| # google.rpc.Status.details field, or localized by the client. | |
| }, | |
| "state": "A String", # [Output Only] Status of the action, which can be one of the following: | |
| # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. | |
| }, | |
| }, | |
| }, | |
| "startTime": "A String", # [Output Only] The time that this operation was started by the server. | |
| # This value is inRFC3339 | |
| # text format. | |
| "status": "A String", # [Output Only] The status of the operation, which can be one of the | |
| # following: | |
| # `PENDING`, `RUNNING`, or `DONE`. | |
| "statusMessage": "A String", # [Output Only] An optional textual description of the current status of the | |
| # operation. | |
| "targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation | |
| # of the target resource. | |
| "targetLink": "A String", # [Output Only] The URL of the resource that the operation modifies. For | |
| # operations related to creating a snapshot, this points to the disk | |
| # that the snapshot was created from. | |
| "user": "A String", # [Output Only] User who requested the operation, for example: | |
| # `user@example.com` or | |
| # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`. | |
| "warnings": [ # [Output Only] If warning messages are generated during processing of the | |
| # operation, this field will be populated. | |
| { | |
| "code": "A String", # [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": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A 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": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| ], | |
| "zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only | |
| # applicable when performing per-zone operations. | |
| }</pre> | |
| </div> | |
| </body></html> |