{ "discoveryVersion": "v1", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "description": "Provides programmatic access to Capacity Planner features.", "basePath": "", "mtlsRootUrl": "https://capacityplanner.mtls.googleapis.com/", "schemas": { "GoogleCloudCapacityplannerV1betaBigQueryDestination": { "id": "GoogleCloudCapacityplannerV1betaBigQueryDestination", "description": "A BigQuery destination for exporting assets to.", "properties": { "table": { "type": "string", "description": "Required. The BigQuery table to which the snapshot result should be written." }, "dataset": { "description": "Required. The BigQuery dataset in format \"projects/{projectId}/datasets/{datasetId}\", to which the snapshot result should be exported. If this dataset does not exist, the export call returns an INVALID_ARGUMENT error.", "type": "string" }, "partitionKey": { "enum": [ "PARTITION_KEY_UNSPECIFIED", "REQUEST_TIME" ], "description": "Optional. The partition key for BigQuery partitioned table.", "enumDescriptions": [ "Unspecified partition key. Tables won't be partitioned using this option.", "The time when the request is received. If specified as partition key, the result table(s) is partitioned by the RequestTime column, an additional timestamp column representing when the request was received." ], "type": "string" }, "createDisposition": { "type": "string", "enumDescriptions": [ "Unspecified create disposition.", "If the table does not exist, BigQuery creates the table.", "If the table does not exist, an error will be returned." ], "description": "Optional. Specifies the action that occurs if the destination table does not exist", "enum": [ "CREATE_DISPOSITION_UNSPECIFIED", "CREATE_IF_NEEDED", "CREATE_NEVER" ] }, "gcsLocation": { "description": "Optional. Specifies the Cloud Storage location. Users can choose to provide a location for Cloud Storage bucket to store the exported data. (as it is possible that some locations are restricted via org policy for that project) Temporary Cloud Storage bucket creation is an interim step for BigQuery upload. If no value is provided, the default location used will be 'US'.", "type": "string" }, "writeDisposition": { "enum": [ "WRITE_DISPOSITION_UNSPECIFIED", "WRITE_APPEND", "WRITE_TRUNCATE", "WRITE_EMPTY" ], "description": "Optional. Specifies the action that occurs if the destination table or partition already exists.", "enumDescriptions": [ "Unspecified write disposition.", "If the table or partition already exists, BigQuery appends the data to the table or the latest partition.", "If the table or partition already exists, BigQuery overwrites the entire table or all the partitions data.", "If the table already exists and contains data, an error is returned." ], "type": "string" } }, "type": "object" }, "GoogleCloudCapacityplannerV1betaTimeSeries": { "description": "A collection of data points that describes the time-varying values of a resource. A time series is identified by its ID. Next : 14", "properties": { "machineShape": { "$ref": "GoogleCloudCapacityplannerV1betaMachineShape", "description": "The machine shape of the time series." }, "isSpot": { "description": "Optional. The location of the usage data in time series.", "type": "boolean" }, "gpuType": { "description": "The GPU type of the time series.", "type": "string" }, "gcsBucketTraffic": { "description": "Output only. The Cloud Storage bucket traffic resource for usage time series.", "readOnly": true, "$ref": "GoogleCloudCapacityplannerV1betaGcsBucketTraffic" }, "tpuType": { "type": "string", "description": "The TPU type of the time series." }, "diskType": { "type": "string", "description": "The disk type for the time series values to return." }, "points": { "description": "The data points of this time series. When listing time series, points are returned in chronological order.", "items": { "$ref": "GoogleCloudCapacityplannerV1betaPoint" }, "type": "array" }, "confidentialMode": { "description": "Optional. The confidential mode for disk.", "type": "boolean" }, "locationType": { "type": "string", "description": "Required. The type of location that the time series is summarizing.", "enumDescriptions": [ "No location type was specified.", "Time series values represent usage aggregated at the region level.", "Time series values represent usage aggregated at the zone level." ], "enum": [ "LOCATION_TYPE_UNSPECIFIED", "REGIONAL", "ZONAL" ] }, "location": { "description": "Optional. The location of the usage data in time series.", "type": "string" }, "cloudResourceType": { "description": "The resource for the time series values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-persistent-disk\", \"gce-gpu\", \"gce-tpu\" and \"gce-vm\".", "type": "string" }, "machineFamily": { "type": "string", "description": "The machine family for the time series values to return. Possible values include \"n1\" and \"n2d\"." }, "unit": { "type": "string", "description": "The units in which the values are reported." } }, "id": "GoogleCloudCapacityplannerV1betaTimeSeries", "type": "object" }, "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstancePropertiesAllocatedDisk": { "id": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstancePropertiesAllocatedDisk", "description": "A specification of the interface and size of disk attached to the instance.", "type": "object", "properties": { "diskSizeGb": { "format": "int64", "description": "Specifies the size of the disk in base-2 GB.", "type": "string" }, "diskInterface": { "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI.", "enum": [ "DISK_INTERFACE_UNSPECIFIED", "SCSI", "NVME", "NVDIMM", "ISCSI" ], "enumDescriptions": [ "Default value. This value is unused.", "SCSI disk interface.", "NVME disk interface.", "NVDIMM disk interface.", "ISCSI disk interface." ], "type": "string" } } }, "GoogleCloudCapacityplannerV1betaMachineShape": { "type": "object", "id": "GoogleCloudCapacityplannerV1betaMachineShape", "properties": { "memoryGb": { "description": "Optional. Total amount of memory with the VM.", "type": "number", "format": "double" }, "machineType": { "description": "Optional. The characteristics of the sampled VM expressed as a string.", "type": "string" }, "localSsdInterface": { "description": "Optional. The local SSD interface used such as nvme or scsi", "type": "string" }, "cpuCores": { "type": "number", "format": "double", "description": "Optional. Number of CPU cores per VM." }, "localSsdPartitions": { "description": "Optional. The number of local SSD partitions per VM.", "type": "string", "format": "int64" }, "gpuType": { "description": "Optional. The type of GPU with the VM.", "type": "string" }, "machineFamily": { "description": "Optional. The VM family.", "type": "string" }, "gpuCores": { "description": "Optional. The number of GPU cores per VM.", "format": "int64", "type": "string" }, "minCpuPlatform": { "description": "Optional. The Min-cpu platform used such as icelake", "type": "string" }, "machineShape": { "type": "string", "description": "Optional. The customer visible string representing the type of VM." }, "localSsdGb": { "format": "double", "type": "number", "description": "Optional. Total amount of local SSD storage." }, "gpuComputeType": { "type": "string", "description": "Optional. The GPU name recognized by Compute Engine APIs." } }, "description": "Machine shape details Next : 13" }, "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocation": { "type": "object", "id": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocation", "description": "This reservation type allows to pre allocate specific instance configuration.", "properties": { "instanceProperties": { "$ref": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstanceProperties", "description": "The instance properties for the reservation." }, "usedCount": { "format": "int64", "description": "Indicates how many instances are in use.", "type": "string" }, "count": { "format": "int64", "description": "Specifies the number of resources that are allocated.", "type": "string" }, "assuredCount": { "format": "int64", "description": "Indicates how many instances are actually usable currently.", "type": "string" } } }, "GoogleCloudCapacityplannerV1betaForecast": { "id": "GoogleCloudCapacityplannerV1betaForecast", "description": "A collection of data points that describes the predicted time-varying values of a resource.", "properties": { "name": { "description": "Identifier. The resource name of the connection in the form of: `projects/{project_id}/locations/{location_id}/forecasts/{forecast_id}` or `organizations/{organization_id}/locations/{location_id}/forecasts/{forecast_id}` or `folders/{folder_id}/locations/{location_id}/forecasts/{forecast_id}`", "type": "string" }, "predictionInterval": { "enumDescriptions": [ "No prediction interval is specified.", "This represents a prediction interval that has 90% confidence. For example, for a symmetric prediction interval, a `PredictionInterval` of `PREDICTION_INTERVAL_90` means that the `UPPER_BOUND` will represent the 95th precentile.", "This represents a prediction interval that has 50% confidence. For example, for a symmetric prediction interval, a `PredictionInterval` of `PREDICTION_INTERVAL_50` means that the `UPPER_BOUND` will represent the 75th precentile." ], "description": "The prediction interval represented by the time series.", "type": "string", "enum": [ "PREDICTION_INTERVAL_UNSPECIFIED", "PREDICTION_INTERVAL_90", "PREDICTION_INTERVAL_50" ] }, "forecastType": { "enumDescriptions": [ "No forecast type is specified.", "Statistical forecast.", "Statistical forecast that attempts to predict the seasonal affects of Black Friday and Cyber Monday.", "Yearly Seasonality model provides generic seasonality beyond BFCM." ], "type": "string", "description": "The type of forecast.", "enum": [ "FORECAST_TYPE_UNSPECIFIED", "STATISTICAL", "STATISTICAL_WITH_BFCM", "YEARLY_SEASONALITY" ] }, "aggregationMethod": { "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ], "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "description": "Aggregation Method of the historical usage for which the forecast is generated", "type": "string" }, "timeSeries": { "description": "The collection of data points that represent the predicted values. Note that some of these values may be in the past (if, for example, the forecast was created in the past and predicted values for the present day).", "$ref": "GoogleCloudCapacityplannerV1betaTimeSeries" }, "bounds": { "enum": [ "BOUNDS_UNSPECIFIED", "LOWER_BOUND", "MEDIAN", "UPPER_BOUND" ], "type": "string", "enumDescriptions": [ "No bounds is specified.", "The time series represents the upper bound of the forecast.", "The time series represents the median expected forecast value.", "The time series represents the lower bound of the forecast." ], "description": "The bounds represented by this forecast time series." } }, "type": "object" }, "GoogleCloudCapacityplannerV1betaFutureReservationStatus": { "properties": { "fulfilledCount": { "type": "string", "format": "int64", "description": "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." }, "autoCreatedReservations": { "type": "array", "description": "Fully qualified urls of the automatically created reservations at start_time.", "items": { "type": "string" } }, "lockTime": { "format": "google-datetime", "type": "string", "description": "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": { "enum": [ "PROCUREMENT_STATUS_UNSPECIFIED", "PENDING_APPROVAL", "APPROVED", "COMMITTED", "DECLINED", "CANCELLED", "PROCURING", "PROVISIONING", "FULFILLED", "FAILED", "FAILED_PARTIALLY_FULFILLED", "DRAFTING", "PENDING_AMENDMENT_APPROVAL" ], "description": "Current state of this Future Reservation", "type": "string", "enumDescriptions": [ "This is unused status value.", "Future reservation is pending approval by Google Cloud Platform.", "Future reservation is approved by Google Cloud Platform.", "Future reservation is committed by the customer.", "Future reservation is rejected by Google Cloud Platform.", "Future reservation is cancelled by the customer.", "Future reservation is being procured by Google Cloud Platform. Beyond this point, Future reservation is locked and no further modifications are allowed.", "Future reservation capacity is being provisioned. This state will be entered after start_time, while reservations are being created to provide total_count reserved instance slots. This state will not persist past start_time + 24h.", "Future reservation is fulfilled completely.", "Future reservation failed. No additional reservations were provided.", "Future reservation is partially fulfilled. Additional reservations were provided but did not reach total_count reserved instance slots.", "Related status for PlanningStatus.Draft. Transitions to PENDING_APPROVAL upon user submitting FR.", "An Amendment to the Future Reservation has been requested. If the Amendment is declined, the Future Reservation will be restored to the last known good state." ] } }, "id": "GoogleCloudCapacityplannerV1betaFutureReservationStatus", "description": "Represents status related to the future reservation.", "type": "object" }, "GoogleLongrunningOperation": { "properties": { "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "GoogleRpcStatus" }, "name": { "type": "string", "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`." }, "response": { "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object" }, "metadata": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object", "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any." } }, "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "id": "GoogleLongrunningOperation" }, "GoogleCloudCapacityplannerV1betaFutureReservationTimeWindow": { "properties": { "startTime": { "format": "google-datetime", "type": "string", "description": "Start time of the Future Reservation." }, "endTime": { "format": "google-datetime", "description": "End time of the Future Reservation.", "type": "string" } }, "type": "object", "description": "Represents time window for the Future Reservation.", "id": "GoogleCloudCapacityplannerV1betaFutureReservationTimeWindow" }, "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstanceProperties": { "properties": { "minCpuPlatform": { "type": "string", "description": "Minimum cpu platform the reservation." }, "localSsd": { "type": "array", "description": "Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.", "items": { "$ref": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstancePropertiesAllocatedDisk" } }, "guestAccelerator": { "type": "array", "items": { "$ref": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstancePropertiesAcceleratorConfig" }, "description": "Specifies accelerator type and count." }, "machineType": { "description": "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.", "type": "string" } }, "type": "object", "description": "Properties of the SKU instances being reserved.", "id": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstanceProperties" }, "GoogleCloudCapacityplannerV1betaExportUsageHistoriesRequest": { "description": "The `ExportUsageHistories` request Next : 12", "properties": { "diskType": { "type": "string", "description": "Optional. The disk_type for the `UsageHistory` values to return request with persistent-disk resource_type. Possible values include \"pd-ssd\", \"pd-standard\", \"pd-balanced\", and \"pd-extreme\"." }, "startDate": { "description": "Optional. The start date of usage.", "$ref": "GoogleTypeDate" }, "tpuType": { "description": "Optional. The TPU type for the `UsageHistory` values to return. Empty tpu_type will return results matching all TPUs.", "type": "string" }, "machineShape": { "$ref": "GoogleCloudCapacityplannerV1betaMachineShape", "description": "Optional. The machine shape for the time series values to export." }, "gpuType": { "type": "string", "description": "Optional. The GPU type for the `UsageHistory` values to return. Sample values are \"nvidia-tesla-t4\", and \"nvidia-tesla-a100\". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs." }, "isSpot": { "type": "boolean", "description": "Optional. The is_spot flag is used to fetch the usage data for preemptible Resources." }, "resourceType": { "type": "string", "description": "Required. The resource for the `UsageHistory` values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-persistent-disk\", \"gce-gpu\" and \"gce-tpu\"." }, "outputConfig": { "$ref": "GoogleCloudCapacityplannerV1betaOutputConfig", "description": "Required. Output configuration indicating where the results will be output to." }, "machineFamily": { "type": "string", "description": "Optional. The machine family for the `UsageHistory` values to return. Possible values include \"n1\", and \"n2d\". See https://cloud.google.com/compute/docs/machine-types for more examples." }, "endDate": { "description": "Optional. The end date of usage.", "$ref": "GoogleTypeDate" }, "usageAggregationMethod": { "type": "string", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "description": "Optional. The method that should be used to convert sampled usage data to daily usage values. AGGREGATION_METHOD_UNSPECIFIED will return results matching all the aggregation methods.", "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ] } }, "id": "GoogleCloudCapacityplannerV1betaExportUsageHistoriesRequest", "type": "object" }, "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesResponse": { "id": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesResponse", "properties": { "usageHistories": { "type": "array", "items": { "$ref": "GoogleCloudCapacityplannerV1betaUsageHistory" }, "description": "The usage histories that match the request." } }, "description": "The `QueryUsageHistories` response.", "type": "object" }, "GoogleCloudCapacityplannerV1betaReservationData": { "type": "object", "properties": { "allocations": { "description": "Allocations filtered by the criteria.", "type": "array", "items": { "$ref": "GoogleCloudCapacityplannerV1betaAllocation" } }, "name": { "description": "Identifier. The resource name of the connection in the form of: `projects/{project_id}/locations/{location_id}/reservations/{reservation_id}` or `organizations/{organization_id}/locations/{location_id}/reservations/{reservation_id}` or `folders/{folder_id}/locations/{location_id}/reservations/{reservation_id}`", "type": "string" }, "usedReservationValues": { "$ref": "GoogleCloudCapacityplannerV1betaTimeSeries", "description": "The collection of data points that represent the aggregated used value for reservations filtered by the criteria." }, "futureReservations": { "items": { "$ref": "GoogleCloudCapacityplannerV1betaFutureReservation" }, "type": "array", "description": "Future reservations filtered by the criteria." }, "timeSeries": { "$ref": "GoogleCloudCapacityplannerV1betaTimeSeries", "description": "The collection of data points that represent the aggregated reserved value for reservations filtered by the criteria." } }, "description": "Response entity for reservations data.", "id": "GoogleCloudCapacityplannerV1betaReservationData" }, "GoogleCloudCapacityplannerV1betaExportForecastsRequest": { "id": "GoogleCloudCapacityplannerV1betaExportForecastsRequest", "properties": { "startDate": { "description": "Optional. The start date of forecasts.", "$ref": "GoogleTypeDate" }, "diskType": { "type": "string", "description": "Optional. The disk_type for the `Forecast` values to return with request persistent-disk resource_type." }, "gpuType": { "type": "string", "description": "Optional. The GPU type for the `Forecast` values to return. Sample values are \"nvidia-tesla-t4\", and \"nvidia-tesla-a100\". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs." }, "endDate": { "$ref": "GoogleTypeDate", "description": "Optional. The end date of forecasts." }, "machineFamily": { "type": "string", "description": "Optional. The machine family to use to select the `Forecast` values to return. Possible values include \"n1\", and \"n2d\"." }, "predictionInterval": { "description": "Optional. The prediction interval to use to select the `Forecast` values to return. PREDICTION_INTERVAL_UNSPECIFIED will return results matching all prediction intervals.", "enumDescriptions": [ "No prediction interval is specified.", "This represents a prediction interval that has 90% confidence. For example, for a symmetric prediction interval, a `PredictionInterval` of `PREDICTION_INTERVAL_90` means that the `UPPER_BOUND` will represent the 95th precentile.", "This represents a prediction interval that has 50% confidence. For example, for a symmetric prediction interval, a `PredictionInterval` of `PREDICTION_INTERVAL_50` means that the `UPPER_BOUND` will represent the 75th precentile." ], "type": "string", "enum": [ "PREDICTION_INTERVAL_UNSPECIFIED", "PREDICTION_INTERVAL_90", "PREDICTION_INTERVAL_50" ] }, "resourceType": { "description": "Required. The resource for the `Forecast` values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-persistent-disk\", \"gce-gpu\" and \"gce-tpu\".", "type": "string" }, "outputConfig": { "description": "Required. Output configuration indicating where the results will be output to.", "$ref": "GoogleCloudCapacityplannerV1betaOutputConfig" }, "aggregationMethod": { "description": "Optional. Aggregation Method of the historical usage for which the forecast is generated.", "type": "string", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ] }, "machineShape": { "description": "Optional. The machine shape for the time series values to export.", "$ref": "GoogleCloudCapacityplannerV1betaMachineShape" }, "tpuType": { "description": "Optional. The TPU type for the `Forecast` values to return. Empty tpu_type will return results matching all TPUs.", "type": "string" } }, "type": "object", "description": "The `ExportForecasts` request Next : 13" }, "GoogleCloudCapacityplannerV1betaFutureReservation": { "description": "Repesents Future Reservation request which is part of aggregated reservations data response of \"QueryReservations\".", "properties": { "timeWindow": { "$ref": "GoogleCloudCapacityplannerV1betaFutureReservationTimeWindow", "description": "Time window for this Future Reservation." }, "zone": { "description": "URL of the Zone where this future reservation resides.", "type": "string" }, "autoCreatedReservationsDeleteTime": { "type": "string", "description": "Future timestamp when the FR auto-created reservations will be deleted by Compute Engine. Format of this field must be a valid RFC3339 value.", "format": "google-datetime" }, "description": { "description": "Description of the future reservation provided by user.", "type": "string" }, "autoDeleteAutoCreatedReservations": { "type": "boolean", "description": "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." }, "id": { "description": "A unique identifier for this future reservation. The server defines this identifier.", "format": "int64", "type": "string" }, "shareSettings": { "description": "List of Projects/Folders to share with.", "$ref": "GoogleCloudCapacityplannerV1betaAllocationShareSettings" }, "createTime": { "format": "google-datetime", "description": "The creation timestamp for this future reservation.", "type": "string" }, "status": { "description": "Status of the Future Reservation", "$ref": "GoogleCloudCapacityplannerV1betaFutureReservationStatus" }, "ownerProjectId": { "type": "string" }, "namePrefix": { "description": "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-####.", "type": "string" }, "specificSkuProperties": { "description": "Future Reservation configuration to indicate instance properties and total count.", "$ref": "GoogleCloudCapacityplannerV1betaFutureReservationSpecificSKUProperties" }, "futureReservation": { "description": "The future reservation resource name.", "type": "string" } }, "type": "object", "id": "GoogleCloudCapacityplannerV1betaFutureReservation" }, "GoogleCloudCapacityplannerV1betaPoint": { "type": "object", "properties": { "value": { "description": "The value of the data point.", "type": "number", "format": "double" }, "eventTime": { "description": "The time which the data point applies.", "type": "string", "format": "google-datetime" } }, "id": "GoogleCloudCapacityplannerV1betaPoint", "description": "A single data point in a time series." }, "GoogleCloudCapacityplannerV1betaFutureReservationSpecificSKUProperties": { "description": "Represents specific SKU properties for the Future Reservation.", "id": "GoogleCloudCapacityplannerV1betaFutureReservationSpecificSKUProperties", "type": "object", "properties": { "instanceProperties": { "$ref": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstanceProperties", "description": "Properties of the SKU instances being reserved." }, "totalCount": { "type": "string", "format": "int64", "description": "Total number of instances for which capacity assurance is requested at a future time period." } } }, "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstancePropertiesAcceleratorConfig": { "type": "object", "description": "A specification of the type and number of accelerator cards attached to the instance.", "id": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocationAllocatedInstancePropertiesAcceleratorConfig", "properties": { "type": { "description": "Accelerator name. See https://cloud.google.com/compute/docs/gpus/#introduction for a full list of accelerator types.", "type": "string" }, "count": { "format": "int32", "type": "integer", "description": "The number of the guest accelerator cards exposed to this instance." } } }, "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesRequest": { "id": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesRequest", "type": "object", "description": "The `QueryUsageHistories` request. Next : 17", "properties": { "locationLevel": { "enumDescriptions": [ "No location type was specified.", "Time series values represent usage aggregated at the region level.", "Time series values represent usage aggregated at the zone level." ], "enum": [ "LOCATION_TYPE_UNSPECIFIED", "REGIONAL", "ZONAL" ], "description": "Optional. The location level of the reservations usage timeseries.", "type": "string" }, "cloudResourceType": { "type": "string", "description": "Required. The resource for the `UsageHistory` values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-persistent-disk\", \"gce-gpu\" and \"gce-tpu\" and \"gcs-bucket-read-throughput\"." }, "usageAggregationMethod": { "type": "string", "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ], "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "description": "Optional. The method that should be used to convert sampled usage data to daily usage values. AGGREGATION_METHOD_UNSPECIFIED will return results matching all the aggregation methods." }, "gpuType": { "type": "string", "description": "Optional. The GPU type for the `UsageHistory` values to return. Sample values are \"nvidia-tesla-t4\", and \"nvidia-tesla-a100\". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs." }, "isSpot": { "description": "Optional. The is_spot flag is used to fetch the usage data for preemptible Resources.", "type": "boolean" }, "diskType": { "description": "Optional. The disk_type for the `UsageHistory` values to return request with persistent-disk cloud_resource_type. Empty disk_type will return results matching all disk types.", "type": "string" }, "tpuType": { "type": "string", "description": "Optional. The TPU type for the `UsageHistory` values to return. Empty tpu_type will return results matching all TPUs." }, "confidentialMode": { "description": "Optional. Whether the persistent disk is in confidential mode.", "type": "boolean" }, "endDate": { "$ref": "GoogleTypeDate", "description": "Optional. The end date of reservations usage." }, "machineFamily": { "description": "Optional. The machine family for the `UsageHistory` values to return. Possible values include \"n1\", and \"n2d\". See https://cloud.google.com/compute/docs/machine-types for more examples. Empty machine_family will return results matching all machine families.", "type": "string" }, "gcsBucketTraffic": { "description": "Optional. Cloud Storage bucket traffic resource for the `UsageHistory` values to return.", "$ref": "GoogleCloudCapacityplannerV1betaGcsBucketTraffic" }, "machineShape": { "$ref": "GoogleCloudCapacityplannerV1betaMachineShape", "description": "Optional. The machine shape for the `UsageHistory` values to return." }, "startDate": { "$ref": "GoogleTypeDate", "description": "Optional. The start date of reservations usage." } } }, "GoogleCloudCapacityplannerV1betaUsageHistory": { "id": "GoogleCloudCapacityplannerV1betaUsageHistory", "type": "object", "properties": { "timeSeries": { "$ref": "GoogleCloudCapacityplannerV1betaTimeSeries", "description": "The collection of data points that represent the historical values." }, "aggregationMethod": { "type": "string", "description": "Method used to convert sampled usage data to time series values.", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ] } }, "description": "A collection of data points that describes the historical time-varying values of a resource." }, "GoogleCloudCapacityplannerV1betaQueryForecastsRequest": { "type": "object", "properties": { "startDate": { "description": "Optional. The start date from which you want the Forecast records to be returned (inclusive).", "$ref": "GoogleTypeDate" }, "aggregationMethod": { "type": "string", "description": "Optional. Aggregation Method of the historical usage for which the forecast is generated", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ] }, "gpuType": { "type": "string", "description": "Optional. The GPU type for the `Forecast` values to return. Sample values are \"nvidia-tesla-t4\", and \"nvidia-tesla-a100\". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs." }, "tpuType": { "description": "Optional. The TPU type for the `Forecast` values to return. Empty tpu_type will return results matching all TPUs.", "type": "string" }, "machineFamily": { "description": "Optional. The machine family to use to select the `Forecast` values to return. Possible values include \"n1\", and \"n2d\". Empty machine_family will return results matching all machine families.", "type": "string" }, "machineShape": { "description": "Optional. The machine shape for the time series values to return.", "$ref": "GoogleCloudCapacityplannerV1betaMachineShape" }, "forecastType": { "enumDescriptions": [ "No forecast type is specified.", "Statistical forecast.", "Statistical forecast that attempts to predict the seasonal affects of Black Friday and Cyber Monday.", "Yearly Seasonality model provides generic seasonality beyond BFCM." ], "type": "string", "enum": [ "FORECAST_TYPE_UNSPECIFIED", "STATISTICAL", "STATISTICAL_WITH_BFCM", "YEARLY_SEASONALITY" ], "description": "Optional. The type of forecast to use to select the `Forecast` values to return. FORECAST_TYPE_UNSPECIFIED will return results matching all the forecast types." }, "generationDate": { "$ref": "GoogleTypeDate", "description": "Optional. If specified, this field returns the Forecast data from the latest run on or after the provided generationDate. If not specificied, this field returns the most recently generated forecast." }, "endDate": { "description": "Optional. The last date until which you want the Forecast records to be returned (inclusive).", "$ref": "GoogleTypeDate" }, "predictionInterval": { "description": "Optional. The prediction interval to use to select the `Forecast` values to return. PREDICTION_INTERVAL_UNSPECIFIED will return results matching all prediction intervals.", "enumDescriptions": [ "No prediction interval is specified.", "This represents a prediction interval that has 90% confidence. For example, for a symmetric prediction interval, a `PredictionInterval` of `PREDICTION_INTERVAL_90` means that the `UPPER_BOUND` will represent the 95th precentile.", "This represents a prediction interval that has 50% confidence. For example, for a symmetric prediction interval, a `PredictionInterval` of `PREDICTION_INTERVAL_50` means that the `UPPER_BOUND` will represent the 75th precentile." ], "type": "string", "enum": [ "PREDICTION_INTERVAL_UNSPECIFIED", "PREDICTION_INTERVAL_90", "PREDICTION_INTERVAL_50" ] }, "confidentialMode": { "description": "Optional. Whether the persistent disk is in confidential mode.", "type": "boolean" }, "cloudResourceType": { "type": "string", "description": "Required. The resource for the `Forecast` values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-persistent-disk\", \"gce-gpu\" and \"gce-tpu\"." }, "diskType": { "description": "Optional. The disk_type for the `Forecast` values to return with request persistent-disk cloud_resource_type. Empty disk_type will return results matching all disk types.", "type": "string" } }, "description": "The `QueryForecasts` request. Next : 17", "id": "GoogleCloudCapacityplannerV1betaQueryForecastsRequest" }, "GoogleCloudCapacityplannerV1betaQueryReservationsResponse": { "type": "object", "id": "GoogleCloudCapacityplannerV1betaQueryReservationsResponse", "properties": { "reservations": { "description": "The reservations data that match the request.", "type": "array", "items": { "$ref": "GoogleCloudCapacityplannerV1betaReservationData" } } }, "description": "The `QueryReservations` response." }, "GoogleCloudCapacityplannerV1betaGcsBucketTraffic": { "description": "Cloud Storage Bucket Traffic attributes for usage and forecast of read/write throughput etc.", "properties": { "bucketLocation": { "description": "Optional. Location of the Cloud Storage bucket e.g. us-central1 (single region), us (multi region) and eur4 - europe-north1 and europe-west4 (dual region).", "type": "string" }, "bucketLocationType": { "enumDescriptions": [ "Unspecified location type.", "Single region location type.", "Dual region location type.", "Multi region location type." ], "enum": [ "LOCATION_TYPE_UNSPECIFIED", "LOCATION_TYPE_SINGLE_REGION", "LOCATION_TYPE_DUAL_REGION", "LOCATION_TYPE_MULTI_REGION" ], "type": "string", "description": "Optional. Location type of the Cloud Storage bucket." }, "trafficPath": { "type": "string", "description": "Optional. Path type for the Cloud Storage bucket traffic.", "enumDescriptions": [ "Unspecified traffic path.", "Traffic path through Google's network.", "Traffic path through the internet." ], "enum": [ "TRAFFIC_PATH_UNSPECIFIED", "TRAFFIC_PATH_GOOGLE", "TRAFFIC_PATH_INTERNET" ] } }, "type": "object", "id": "GoogleCloudCapacityplannerV1betaGcsBucketTraffic" }, "GoogleCloudCapacityplannerV1betaGcsDestination": { "properties": { "force": { "description": "Optional. Flag to indicate overwrite in case file already exists.", "type": "boolean" }, "uri": { "deprecated": true, "type": "string", "description": "Optional. Deprecated: Use `bucket` and `object` instead. The path to the file in Cloud Storage where the export will be stored. The URI is in the form `gs://bucketName/fileName`. If the file already exists, the request succeeds, but the operation fails." }, "bucket": { "description": "Required. The bucket name to which the export will be stored.", "type": "string" }, "object": { "description": "Required. The object name to which the export will be stored.", "type": "string" } }, "type": "object", "description": "A Cloud Storage location.", "id": "GoogleCloudCapacityplannerV1betaGcsDestination" }, "GoogleRpcStatus": { "id": "GoogleRpcStatus", "description": "The `Status` type defines a logical error model that is suitable for 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).", "properties": { "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } }, "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "message": { "description": "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.", "type": "string" } }, "type": "object" }, "GoogleTypeDate": { "type": "object", "id": "GoogleTypeDate", "properties": { "month": { "format": "int32", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "type": "integer" }, "day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "type": "integer", "format": "int32" }, "year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "type": "integer", "format": "int32" } }, "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp" }, "GoogleCloudCapacityplannerV1betaAllocation": { "description": "Repesents Allocation which is part of aggregated reservations data response of \"QueryReservations\".", "type": "object", "properties": { "description": { "type": "string", "description": "A description while creating reservation." }, "specificAllocation": { "$ref": "GoogleCloudCapacityplannerV1betaAllocationSpecificSKUAllocation", "description": "Reservation for instances with specific machine shapes." }, "status": { "description": "The status of the reservation.", "enum": [ "STATUS_UNSPECIFIED", "INVALID", "CREATING", "READY", "DELETING", "UPDATING" ], "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Invalid Reservation", "Resources are being allocated for the reservation.", "Reservation has allocated all its resources.", "Reservation is currently being deleted.", "Reservation is currently being resized." ] }, "createTime": { "type": "string", "format": "google-datetime", "description": "The creation timestamp for this allocation." }, "allocation": { "description": "The reservation resource name.", "type": "string" }, "id": { "description": "The unique identifier for the resource. This identifier is defined by the server.", "format": "int64", "type": "string" }, "shareSettings": { "description": "Specify share-settings to create a shared reservation.", "$ref": "GoogleCloudCapacityplannerV1betaAllocationShareSettings" }, "zone": { "type": "string", "description": "Zone in which the reservation resides." }, "ownerProjectId": { "type": "string" }, "autoDeleteTime": { "type": "string", "description": "Absolute time in future when the reservation will be auto-deleted by Compute Engine.", "format": "google-datetime" } }, "id": "GoogleCloudCapacityplannerV1betaAllocation" }, "GoogleCloudCapacityplannerV1betaExportReservationsUsageRequest": { "id": "GoogleCloudCapacityplannerV1betaExportReservationsUsageRequest", "properties": { "startDate": { "$ref": "GoogleTypeDate", "description": "Optional. The start date of reservations usage." }, "usageAggregationMethod": { "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ], "type": "string", "description": "Required. The method that should be used to convert sampled reservations data to daily usage values.", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ] }, "machineShape": { "description": "Optional. The machine_shape as a filter to select matching reservations and its usage.", "$ref": "GoogleCloudCapacityplannerV1betaMachineShape" }, "cloudResourceType": { "type": "string", "description": "Required. The resource for the `ReservationsUsage` values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", and \"gce-gpu\"." }, "gpuType": { "type": "string", "description": "Optional. The GPU type to query reservations and usage by. For example: NVIDIA T4." }, "endDate": { "$ref": "GoogleTypeDate", "description": "Optional. The end date of reservations usage." }, "outputConfig": { "description": "Required. Output configuration indicating where the results will be output to.", "$ref": "GoogleCloudCapacityplannerV1betaOutputConfig" }, "machineFamily": { "type": "string", "description": "Optional. The machine family to query reservations and usage by. For example: n1, n2d." }, "shareType": { "description": "Optional. Type of share settings to filter reservations in response. If unspecified, all types are included.", "enumDescriptions": [ "No share type specified.", "Default value, for which reservation is open to only owner project.", "Shared-reservation is open to specific projects." ], "enum": [ "SHARE_TYPE_UNSPECIFIED", "SHARE_TYPE_LOCAL", "SHARE_TYPE_SPECIFIC_PROJECTS" ], "type": "string" }, "locationLevel": { "enum": [ "LOCATION_TYPE_UNSPECIFIED", "REGIONAL", "ZONAL" ], "type": "string", "enumDescriptions": [ "No location type was specified.", "Time series values represent usage aggregated at the region level.", "Time series values represent usage aggregated at the zone level." ], "description": "Optional. The location level of the reservations usage timeseries." } }, "type": "object", "description": "The `ExportReservationsUsage` request" }, "GoogleCloudCapacityplannerV1betaAllocationShareSettings": { "id": "GoogleCloudCapacityplannerV1betaAllocationShareSettings", "type": "object", "properties": { "shareType": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Shared-reservation is open to entire Organization", "Shared-reservation is open to specific projects", "Default value.", "Shared-reservation is open to direct child projects of specific folders." ], "description": "Type of sharing for this shared-reservation", "enum": [ "SHARE_TYPE_UNSPECIFIED", "ORGANIZATION", "SPECIFIC_PROJECTS", "LOCAL", "DIRECT_PROJECTS_UNDER_SPECIFIC_FOLDERS" ] }, "projects": { "items": { "type": "string" }, "type": "array", "description": "A List of Project names to specify consumer projects for this shared-reservation. This is only valid when share_type's value is SPECIFIC_PROJECTS." } }, "description": "The share setting for reservation." }, "GoogleCloudCapacityplannerV1betaOutputConfig": { "id": "GoogleCloudCapacityplannerV1betaOutputConfig", "type": "object", "properties": { "gcsDestination": { "description": "Destination on Cloud Storage.", "$ref": "GoogleCloudCapacityplannerV1betaGcsDestination" }, "bigqueryDestination": { "description": "Destination on BigQuery.", "$ref": "GoogleCloudCapacityplannerV1betaBigQueryDestination" } }, "description": "Output configuration for export destination." }, "GoogleCloudCapacityplannerV1betaQueryForecastsResponse": { "id": "GoogleCloudCapacityplannerV1betaQueryForecastsResponse", "properties": { "forecasts": { "type": "array", "description": "The forecasts that match the request.", "items": { "$ref": "GoogleCloudCapacityplannerV1betaForecast" } } }, "description": "The `QueryForecasts` response.", "type": "object" } }, "batchPath": "batch", "id": "capacityplanner:v1beta", "title": "Capacity Planner API", "name": "capacityplanner", "servicePath": "", "revision": "20261012", "resources": { "folders": { "resources": { "locations": { "resources": { "reservations": { "methods": { "query": { "description": "Returns a list of the reservations that are in the parent parameter and match your specified filters.", "parameters": { "aggregationMethod": { "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ], "location": "query", "type": "string", "description": "Optional. Aggregation Method of the historical reservation usage", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ] }, "startDate.year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "location": "query", "type": "integer", "format": "int32" }, "startDate.day": { "format": "int32", "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "location": "query", "type": "integer" }, "machineShape.cpuCores": { "description": "Optional. Number of CPU cores per VM.", "type": "number", "location": "query", "format": "double" }, "includeUnapprovedReservations": { "location": "query", "description": "Optional. Whether to include pending for approval reservations in the response. This field is only applicable for future reservations.", "type": "boolean" }, "machineShape.gpuComputeType": { "location": "query", "type": "string", "description": "Optional. The GPU name recognized by Compute Engine APIs." }, "machineShape.memoryGb": { "description": "Optional. Total amount of memory with the VM.", "location": "query", "type": "number", "format": "double" }, "machineShape.localSsdGb": { "type": "number", "description": "Optional. Total amount of local SSD storage.", "location": "query", "format": "double" }, "machineShape.minCpuPlatform": { "location": "query", "type": "string", "description": "Optional. The Min-cpu platform used such as icelake" }, "reservationType": { "description": "Required. The Reservation type for example, future reservation request and allocation. If unspecified, all types are included.", "type": "string", "location": "query", "enum": [ "RESERVATION_TYPE_UNSPECIFIED", "RESERVATION_TYPE_ALLOCATION", "RESERVATION_TYPE_FUTURE_RESERVATION", "RESERVATION_TYPE_ALL" ], "enumDescriptions": [ "No reservation type specified.", "Allocation refers to realized reservation either auto created or created by the users on demand.", "Future Reservation requests created by users.", "All reservations." ] }, "endDate.month": { "type": "integer", "location": "query", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "format": "int32" }, "gpuType": { "type": "string", "description": "Optional. The GPU type for the reserved values to return. Sample values are \"nvidia-tesla-t4\", and \"nvidia-tesla-a100\". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs.", "location": "query" }, "machineShape.localSsdPartitions": { "type": "string", "description": "Optional. The number of local SSD partitions per VM.", "format": "int64", "location": "query" }, "ownershipType": { "enum": [ "OWNERSHIP_TYPE_UNSPECIFIED", "OWNERSHIP_TYPE_OWNED", "OWNERSHIP_TYPE_SHARED_BY_OTHERS" ], "type": "string", "description": "Optional. Types of ownerships to filter reservations based on. In case of OWNED, it filters reservations which are owned by selected parent project/folder/organization. If unspecified, all types are included.", "location": "query", "enumDescriptions": [ "No ownership status specified.", "For the reservations owned within selected Google Cloud Platform Resource Container (project/folder/organization).", "For the reservations consumable within selected Google Cloud Platform Resource Container (project/folder/organization), but not owned by them." ] }, "machineShape.gpuCores": { "type": "string", "location": "query", "description": "Optional. The number of GPU cores per VM.", "format": "int64" }, "locationLevel": { "enumDescriptions": [ "No location type was specified.", "Time series values represent usage aggregated at the region level.", "Time series values represent usage aggregated at the zone level." ], "description": "Optional. The location level of the reservations usage timeseries.", "enum": [ "LOCATION_TYPE_UNSPECIFIED", "REGIONAL", "ZONAL" ], "location": "query", "type": "string" }, "machineShape.machineShape": { "description": "Optional. The customer visible string representing the type of VM.", "type": "string", "location": "query" }, "endDate.year": { "format": "int32", "location": "query", "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "type": "integer" }, "machineShape.machineFamily": { "type": "string", "location": "query", "description": "Optional. The VM family." }, "endDate.day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "location": "query", "type": "integer", "format": "int32" }, "machineFamily": { "location": "query", "type": "string", "description": "Optional. The machine family to use to select the aggregate reserved values to return. Possible values include \"n1\", and \"n2d\" etc. Empty machine_family will return results matching all machine families." }, "machineShape.gpuType": { "description": "Optional. The type of GPU with the VM.", "type": "string", "location": "query" }, "parent": { "required": true, "type": "string", "location": "path", "pattern": "^folders/[^/]+/locations/[^/]+$", "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}" }, "machineShape.machineType": { "description": "Optional. The characteristics of the sampled VM expressed as a string.", "location": "query", "type": "string" }, "cloudResourceType": { "type": "string", "description": "Required. The resource for the reserved values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-gpu\" and \"gce-vm\".", "location": "query" }, "startDate.month": { "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "location": "query", "type": "integer", "format": "int32" }, "shareType": { "location": "query", "type": "string", "enumDescriptions": [ "No share type specified.", "Default value, for which reservation is open to only owner project.", "Shared-reservation is open to specific projects." ], "enum": [ "SHARE_TYPE_UNSPECIFIED", "SHARE_TYPE_LOCAL", "SHARE_TYPE_SPECIFIC_PROJECTS" ], "description": "Optional. Types of share settings to filter reservations in response. If unspecified, all types are included." }, "reservationDataLevel": { "type": "string", "enumDescriptions": [ "No reservation data level specified.", "aggregated reservations data in a timeseries or aggregation over timeseries.", "per reservation detail which is equivalent of Arcus Future Reservation or Allocation with only limited fields which are useful for Capacity Planning." ], "enum": [ "RESERVATION_DATA_LEVEL_UNSPECIFIED", "RESERVATION_DATA_LEVEL_AGGREGATED", "RESERVATION_DATA_LEVEL_PER_RESERVATION" ], "description": "Required. Reservations output data format.", "location": "query" }, "machineShape.localSsdInterface": { "description": "Optional. The local SSD interface used such as nvme or scsi", "type": "string", "location": "query" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryReservationsResponse" }, "path": "v1beta/{+parent}/reservations:query", "id": "capacityplanner.folders.locations.reservations.query", "flatPath": "v1beta/folders/{foldersId}/locations/{locationsId}/reservations:query" } } }, "forecasts": { "methods": { "export": { "parameterOrder": [ "parent" ], "path": "v1beta/{+parent}/forecasts:export", "id": "capacityplanner.folders.locations.forecasts.export", "httpMethod": "POST", "description": "Exports forecasted usage data requested by user into either an existing Cloud Storage bucket or a BigQuery table.", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "parameters": { "parent": { "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "required": true, "pattern": "^folders/[^/]+/locations/[^/]+$", "type": "string", "location": "path" } }, "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportForecastsRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta/folders/{foldersId}/locations/{locationsId}/forecasts:export" }, "query": { "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^folders/[^/]+/locations/[^/]+$", "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}" } }, "request": { "$ref": "GoogleCloudCapacityplannerV1betaQueryForecastsRequest" }, "httpMethod": "POST", "flatPath": "v1beta/folders/{foldersId}/locations/{locationsId}/forecasts:query", "id": "capacityplanner.folders.locations.forecasts.query", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "path": "v1beta/{+parent}/forecasts:query", "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryForecastsResponse" }, "description": "Returns a list of the forecasts that are in the parent parameter and match your specified filters." } } }, "usageHistories": { "methods": { "query": { "request": { "$ref": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesRequest" }, "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "httpMethod": "POST", "parameterOrder": [ "parent" ], "description": "Returns a list of the usage histories that are in the parent parameter and match your specified filters.", "flatPath": "v1beta/folders/{foldersId}/locations/{locationsId}/usageHistories:query", "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesResponse" }, "parameters": { "parent": { "required": true, "location": "path", "pattern": "^folders/[^/]+/locations/[^/]+$", "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "type": "string" } }, "id": "capacityplanner.folders.locations.usageHistories.query", "path": "v1beta/{+parent}/usageHistories:query" }, "export": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "id": "capacityplanner.folders.locations.usageHistories.export", "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportUsageHistoriesRequest" }, "description": "Exports historical usage data requested by user into either an existing Cloud Storage bucket or a BigQuery table.", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta/folders/{foldersId}/locations/{locationsId}/usageHistories:export", "path": "v1beta/{+parent}/usageHistories:export", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^folders/[^/]+/locations/[^/]+$", "location": "path", "type": "string", "required": true, "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}" } } } } }, "reservationsUsage": { "methods": { "export": { "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportReservationsUsageRequest" }, "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "httpMethod": "POST", "parameterOrder": [ "parent" ], "id": "capacityplanner.folders.locations.reservationsUsage.export", "path": "v1beta/{+parent}/reservationsUsage:export", "description": "Exports reservations usage data requested by user into either an existing Cloud Storage bucket or a new/existing BigQuery table.", "flatPath": "v1beta/folders/{foldersId}/locations/{locationsId}/reservationsUsage:export", "parameters": { "parent": { "type": "string", "pattern": "^folders/[^/]+/locations/[^/]+$", "required": true, "description": "Required. The compute engine resource and location of the reservationsusage. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "location": "path" } }, "response": { "$ref": "GoogleLongrunningOperation" } } } } } } } }, "organizations": { "resources": { "locations": { "resources": { "reservations": { "methods": { "query": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "location": "path" }, "machineShape.machineType": { "location": "query", "type": "string", "description": "Optional. The characteristics of the sampled VM expressed as a string." }, "machineShape.localSsdGb": { "location": "query", "type": "number", "description": "Optional. Total amount of local SSD storage.", "format": "double" }, "gpuType": { "location": "query", "type": "string", "description": "Optional. The GPU type for the reserved values to return. Sample values are \"nvidia-tesla-t4\", and \"nvidia-tesla-a100\". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs." }, "startDate.day": { "location": "query", "type": "integer", "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "format": "int32" }, "machineShape.gpuCores": { "location": "query", "description": "Optional. The number of GPU cores per VM.", "type": "string", "format": "int64" }, "startDate.month": { "type": "integer", "format": "int32", "location": "query", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day." }, "ownershipType": { "enumDescriptions": [ "No ownership status specified.", "For the reservations owned within selected Google Cloud Platform Resource Container (project/folder/organization).", "For the reservations consumable within selected Google Cloud Platform Resource Container (project/folder/organization), but not owned by them." ], "type": "string", "description": "Optional. Types of ownerships to filter reservations based on. In case of OWNED, it filters reservations which are owned by selected parent project/folder/organization. If unspecified, all types are included.", "location": "query", "enum": [ "OWNERSHIP_TYPE_UNSPECIFIED", "OWNERSHIP_TYPE_OWNED", "OWNERSHIP_TYPE_SHARED_BY_OTHERS" ] }, "locationLevel": { "description": "Optional. The location level of the reservations usage timeseries.", "location": "query", "enumDescriptions": [ "No location type was specified.", "Time series values represent usage aggregated at the region level.", "Time series values represent usage aggregated at the zone level." ], "enum": [ "LOCATION_TYPE_UNSPECIFIED", "REGIONAL", "ZONAL" ], "type": "string" }, "machineShape.memoryGb": { "type": "number", "description": "Optional. Total amount of memory with the VM.", "location": "query", "format": "double" }, "aggregationMethod": { "description": "Optional. Aggregation Method of the historical reservation usage", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "type": "string", "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ], "location": "query" }, "machineShape.cpuCores": { "description": "Optional. Number of CPU cores per VM.", "format": "double", "type": "number", "location": "query" }, "endDate.month": { "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "location": "query", "format": "int32", "type": "integer" }, "machineFamily": { "location": "query", "type": "string", "description": "Optional. The machine family to use to select the aggregate reserved values to return. Possible values include \"n1\", and \"n2d\" etc. Empty machine_family will return results matching all machine families." }, "machineShape.machineFamily": { "description": "Optional. The VM family.", "location": "query", "type": "string" }, "endDate.day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "format": "int32", "location": "query", "type": "integer" }, "endDate.year": { "format": "int32", "type": "integer", "location": "query", "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year." }, "machineShape.gpuComputeType": { "description": "Optional. The GPU name recognized by Compute Engine APIs.", "type": "string", "location": "query" }, "shareType": { "enumDescriptions": [ "No share type specified.", "Default value, for which reservation is open to only owner project.", "Shared-reservation is open to specific projects." ], "type": "string", "description": "Optional. Types of share settings to filter reservations in response. If unspecified, all types are included.", "enum": [ "SHARE_TYPE_UNSPECIFIED", "SHARE_TYPE_LOCAL", "SHARE_TYPE_SPECIFIC_PROJECTS" ], "location": "query" }, "includeUnapprovedReservations": { "location": "query", "type": "boolean", "description": "Optional. Whether to include pending for approval reservations in the response. This field is only applicable for future reservations." }, "reservationDataLevel": { "type": "string", "enum": [ "RESERVATION_DATA_LEVEL_UNSPECIFIED", "RESERVATION_DATA_LEVEL_AGGREGATED", "RESERVATION_DATA_LEVEL_PER_RESERVATION" ], "location": "query", "description": "Required. Reservations output data format.", "enumDescriptions": [ "No reservation data level specified.", "aggregated reservations data in a timeseries or aggregation over timeseries.", "per reservation detail which is equivalent of Arcus Future Reservation or Allocation with only limited fields which are useful for Capacity Planning." ] }, "machineShape.localSsdInterface": { "type": "string", "description": "Optional. The local SSD interface used such as nvme or scsi", "location": "query" }, "cloudResourceType": { "description": "Required. The resource for the reserved values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-gpu\" and \"gce-vm\".", "type": "string", "location": "query" }, "machineShape.minCpuPlatform": { "type": "string", "description": "Optional. The Min-cpu platform used such as icelake", "location": "query" }, "machineShape.localSsdPartitions": { "location": "query", "format": "int64", "type": "string", "description": "Optional. The number of local SSD partitions per VM." }, "machineShape.gpuType": { "type": "string", "location": "query", "description": "Optional. The type of GPU with the VM." }, "machineShape.machineShape": { "description": "Optional. The customer visible string representing the type of VM.", "type": "string", "location": "query" }, "startDate.year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "location": "query", "type": "integer", "format": "int32" }, "reservationType": { "type": "string", "enum": [ "RESERVATION_TYPE_UNSPECIFIED", "RESERVATION_TYPE_ALLOCATION", "RESERVATION_TYPE_FUTURE_RESERVATION", "RESERVATION_TYPE_ALL" ], "location": "query", "description": "Required. The Reservation type for example, future reservation request and allocation. If unspecified, all types are included.", "enumDescriptions": [ "No reservation type specified.", "Allocation refers to realized reservation either auto created or created by the users on demand.", "Future Reservation requests created by users.", "All reservations." ] } }, "description": "Returns a list of the reservations that are in the parent parameter and match your specified filters.", "path": "v1beta/{+parent}/reservations:query", "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/reservations:query", "id": "capacityplanner.organizations.locations.reservations.query", "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryReservationsResponse" }, "httpMethod": "GET" } } }, "forecasts": { "methods": { "export": { "path": "v1beta/{+parent}/forecasts:export", "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportForecastsRequest" }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "description": "Exports forecasted usage data requested by user into either an existing Cloud Storage bucket or a BigQuery table.", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "parameters": { "parent": { "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+$", "type": "string", "location": "path" } }, "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/forecasts:export", "id": "capacityplanner.organizations.locations.forecasts.export", "response": { "$ref": "GoogleLongrunningOperation" } }, "query": { "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "parameterOrder": [ "parent" ], "parameters": { "parent": { "required": true, "type": "string", "pattern": "^organizations/[^/]+/locations/[^/]+$", "location": "path", "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}" } }, "path": "v1beta/{+parent}/forecasts:query", "id": "capacityplanner.organizations.locations.forecasts.query", "httpMethod": "POST", "description": "Returns a list of the forecasts that are in the parent parameter and match your specified filters.", "request": { "$ref": "GoogleCloudCapacityplannerV1betaQueryForecastsRequest" }, "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryForecastsResponse" }, "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/forecasts:query" } } }, "reservationsUsage": { "methods": { "export": { "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/reservationsUsage:export", "id": "capacityplanner.organizations.locations.reservationsUsage.export", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, "description": "Required. The compute engine resource and location of the reservationsusage. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "location": "path" } }, "httpMethod": "POST", "path": "v1beta/{+parent}/reservationsUsage:export", "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportReservationsUsageRequest" }, "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "description": "Exports reservations usage data requested by user into either an existing Cloud Storage bucket or a new/existing BigQuery table." } } }, "usageHistories": { "methods": { "query": { "id": "capacityplanner.organizations.locations.usageHistories.query", "parameterOrder": [ "parent" ], "parameters": { "parent": { "required": true, "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "type": "string", "pattern": "^organizations/[^/]+/locations/[^/]+$", "location": "path" } }, "path": "v1beta/{+parent}/usageHistories:query", "request": { "$ref": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesRequest" }, "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/usageHistories:query", "description": "Returns a list of the usage histories that are in the parent parameter and match your specified filters.", "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesResponse" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ] }, "export": { "id": "capacityplanner.organizations.locations.usageHistories.export", "parameters": { "parent": { "pattern": "^organizations/[^/]+/locations/[^/]+$", "type": "string", "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "required": true, "location": "path" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/usageHistories:export", "path": "v1beta/{+parent}/usageHistories:export", "description": "Exports historical usage data requested by user into either an existing Cloud Storage bucket or a BigQuery table.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportUsageHistoriesRequest" } } } } } } } }, "projects": { "resources": { "operations": { "methods": { "get": { "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/operations/[^/]+$" } }, "path": "v1beta/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta/projects/{projectsId}/operations/{operationsId}", "id": "capacityplanner.projects.operations.get", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "httpMethod": "GET" } } }, "locations": { "resources": { "reservations": { "methods": { "query": { "description": "Returns a list of the reservations that are in the parent parameter and match your specified filters.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}" }, "gpuType": { "type": "string", "description": "Optional. The GPU type for the reserved values to return. Sample values are \"nvidia-tesla-t4\", and \"nvidia-tesla-a100\". See https://cloud.google.com/compute/docs/gpus for a list. Empty gpu_type will return results matching all GPUs.", "location": "query" }, "machineShape.minCpuPlatform": { "type": "string", "location": "query", "description": "Optional. The Min-cpu platform used such as icelake" }, "cloudResourceType": { "type": "string", "description": "Required. The resource for the reserved values to return. Possible values include \"gce-vcpus\", \"gce-ram\", \"gce-local-ssd\", \"gce-gpu\" and \"gce-vm\".", "location": "query" }, "reservationType": { "enum": [ "RESERVATION_TYPE_UNSPECIFIED", "RESERVATION_TYPE_ALLOCATION", "RESERVATION_TYPE_FUTURE_RESERVATION", "RESERVATION_TYPE_ALL" ], "type": "string", "location": "query", "description": "Required. The Reservation type for example, future reservation request and allocation. If unspecified, all types are included.", "enumDescriptions": [ "No reservation type specified.", "Allocation refers to realized reservation either auto created or created by the users on demand.", "Future Reservation requests created by users.", "All reservations." ] }, "machineShape.gpuType": { "description": "Optional. The type of GPU with the VM.", "type": "string", "location": "query" }, "machineShape.localSsdInterface": { "location": "query", "type": "string", "description": "Optional. The local SSD interface used such as nvme or scsi" }, "machineShape.machineType": { "location": "query", "type": "string", "description": "Optional. The characteristics of the sampled VM expressed as a string." }, "machineShape.localSsdPartitions": { "description": "Optional. The number of local SSD partitions per VM.", "format": "int64", "location": "query", "type": "string" }, "shareType": { "enumDescriptions": [ "No share type specified.", "Default value, for which reservation is open to only owner project.", "Shared-reservation is open to specific projects." ], "location": "query", "type": "string", "enum": [ "SHARE_TYPE_UNSPECIFIED", "SHARE_TYPE_LOCAL", "SHARE_TYPE_SPECIFIC_PROJECTS" ], "description": "Optional. Types of share settings to filter reservations in response. If unspecified, all types are included." }, "endDate.year": { "format": "int32", "location": "query", "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "type": "integer" }, "machineFamily": { "location": "query", "description": "Optional. The machine family to use to select the aggregate reserved values to return. Possible values include \"n1\", and \"n2d\" etc. Empty machine_family will return results matching all machine families.", "type": "string" }, "machineShape.gpuComputeType": { "description": "Optional. The GPU name recognized by Compute Engine APIs.", "location": "query", "type": "string" }, "reservationDataLevel": { "location": "query", "enumDescriptions": [ "No reservation data level specified.", "aggregated reservations data in a timeseries or aggregation over timeseries.", "per reservation detail which is equivalent of Arcus Future Reservation or Allocation with only limited fields which are useful for Capacity Planning." ], "type": "string", "enum": [ "RESERVATION_DATA_LEVEL_UNSPECIFIED", "RESERVATION_DATA_LEVEL_AGGREGATED", "RESERVATION_DATA_LEVEL_PER_RESERVATION" ], "description": "Required. Reservations output data format." }, "endDate.day": { "location": "query", "type": "integer", "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "format": "int32" }, "startDate.month": { "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "format": "int32", "type": "integer", "location": "query" }, "endDate.month": { "type": "integer", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "format": "int32", "location": "query" }, "includeUnapprovedReservations": { "location": "query", "description": "Optional. Whether to include pending for approval reservations in the response. This field is only applicable for future reservations.", "type": "boolean" }, "ownershipType": { "enumDescriptions": [ "No ownership status specified.", "For the reservations owned within selected Google Cloud Platform Resource Container (project/folder/organization).", "For the reservations consumable within selected Google Cloud Platform Resource Container (project/folder/organization), but not owned by them." ], "description": "Optional. Types of ownerships to filter reservations based on. In case of OWNED, it filters reservations which are owned by selected parent project/folder/organization. If unspecified, all types are included.", "type": "string", "location": "query", "enum": [ "OWNERSHIP_TYPE_UNSPECIFIED", "OWNERSHIP_TYPE_OWNED", "OWNERSHIP_TYPE_SHARED_BY_OTHERS" ] }, "locationLevel": { "enum": [ "LOCATION_TYPE_UNSPECIFIED", "REGIONAL", "ZONAL" ], "location": "query", "type": "string", "description": "Optional. The location level of the reservations usage timeseries.", "enumDescriptions": [ "No location type was specified.", "Time series values represent usage aggregated at the region level.", "Time series values represent usage aggregated at the zone level." ] }, "machineShape.gpuCores": { "location": "query", "description": "Optional. The number of GPU cores per VM.", "format": "int64", "type": "string" }, "aggregationMethod": { "enum": [ "AGGREGATION_METHOD_UNSPECIFIED", "MEDIAN", "PEAK", "P50", "P75", "P99", "P100" ], "location": "query", "enumDescriptions": [ "No aggregation method is specified.", "", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the 50th(median) percentile of the sampled values.", "Time series values represent the 75th percentile of the sampled values.", "Time series values represent the 99th percentile of the sampled values.", "Time series values represent the max of the sampled values." ], "type": "string", "description": "Optional. Aggregation Method of the historical reservation usage" }, "machineShape.machineFamily": { "description": "Optional. The VM family.", "location": "query", "type": "string" }, "machineShape.localSsdGb": { "type": "number", "format": "double", "location": "query", "description": "Optional. Total amount of local SSD storage." }, "startDate.day": { "format": "int32", "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "type": "integer", "location": "query" }, "startDate.year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "location": "query", "type": "integer", "format": "int32" }, "machineShape.cpuCores": { "type": "number", "description": "Optional. Number of CPU cores per VM.", "location": "query", "format": "double" }, "machineShape.memoryGb": { "location": "query", "description": "Optional. Total amount of memory with the VM.", "type": "number", "format": "double" }, "machineShape.machineShape": { "type": "string", "description": "Optional. The customer visible string representing the type of VM.", "location": "query" } }, "path": "v1beta/{+parent}/reservations:query", "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryReservationsResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "id": "capacityplanner.projects.locations.reservations.query", "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/reservations:query", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ] } } }, "forecasts": { "methods": { "export": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "description": "Exports forecasted usage data requested by user into either an existing Cloud Storage bucket or a BigQuery table.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "type": "string" } }, "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportForecastsRequest" }, "parameterOrder": [ "parent" ], "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/forecasts:export", "path": "v1beta/{+parent}/forecasts:export", "id": "capacityplanner.projects.locations.forecasts.export" }, "query": { "parameterOrder": [ "parent" ], "path": "v1beta/{+parent}/forecasts:query", "id": "capacityplanner.projects.locations.forecasts.query", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryForecastsResponse" }, "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/forecasts:query", "httpMethod": "POST", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "description": "Returns a list of the forecasts that are in the parent parameter and match your specified filters.", "request": { "$ref": "GoogleCloudCapacityplannerV1betaQueryForecastsRequest" } } } }, "usageHistories": { "methods": { "query": { "response": { "$ref": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesResponse" }, "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/usageHistories:query", "description": "Returns a list of the usage histories that are in the parent parameter and match your specified filters.", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/capacityplanner.read-only", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "path": "v1beta/{+parent}/usageHistories:query", "request": { "$ref": "GoogleCloudCapacityplannerV1betaQueryUsageHistoriesRequest" }, "parameters": { "parent": { "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "required": true, "location": "path" } }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "id": "capacityplanner.projects.locations.usageHistories.query" }, "export": { "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/usageHistories:export", "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportUsageHistoriesRequest" }, "id": "capacityplanner.projects.locations.usageHistories.export", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "path": "v1beta/{+parent}/usageHistories:export", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The compute engine resource and location for the time series values to return. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "required": true, "location": "path" } }, "description": "Exports historical usage data requested by user into either an existing Cloud Storage bucket or a BigQuery table.", "parameterOrder": [ "parent" ] } } }, "reservationsUsage": { "methods": { "export": { "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/reservationsUsage:export", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Exports reservations usage data requested by user into either an existing Cloud Storage bucket or a new/existing BigQuery table.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/capacityplanner", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/devstorage.full_control" ], "id": "capacityplanner.projects.locations.reservationsUsage.export", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudCapacityplannerV1betaExportReservationsUsageRequest" }, "parameters": { "parent": { "description": "Required. The compute engine resource and location of the reservationsusage. The format is: projects/{project}/locations/{location} or organizations/{organization}/locations/{location} or folders/{folder}/locations/{location}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" } }, "path": "v1beta/{+parent}/reservationsUsage:export" } } } } } } } }, "version_module": true, "baseUrl": "https://capacityplanner.googleapis.com/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/devstorage.full_control": { "description": "Manage your data and permissions in Cloud Storage and see the email address for your Google Account" }, "https://www.googleapis.com/auth/capacityplanner": { "description": "See, edit, configure, and delete your Google Cloud Capacity Planner data and see the email address for your Google Account" }, "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "https://www.googleapis.com/auth/capacityplanner.read-only": { "description": "See your Google Cloud Capacity Planner data and the email address of your Google Account" } } } }, "kind": "discovery#restDescription", "ownerDomain": "google.com", "parameters": { "quotaUser": { "type": "string", "location": "query", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters." }, "access_token": { "type": "string", "location": "query", "description": "OAuth access token." }, "callback": { "type": "string", "location": "query", "description": "JSONP" }, "prettyPrint": { "type": "boolean", "location": "query", "description": "Returns response with indentations and line breaks.", "default": "true" }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "location": "query", "type": "string" }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query", "type": "string" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "$.xgafv": { "description": "V1 error format.", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ], "type": "string", "location": "query" }, "fields": { "type": "string", "location": "query", "description": "Selector specifying which fields to include in a partial response." }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "type": "string", "location": "query" }, "alt": { "description": "Data format for response.", "type": "string", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "default": "json", "location": "query" } }, "protocol": "rest", "canonicalName": "Capacity Planner", "documentationLink": "https://cloud.google.com/capacity-planner/docs", "rootUrl": "https://capacityplanner.googleapis.com/", "ownerName": "Google", "version": "v1beta", "fullyEncodeReservedExpansion": true }