{ "servicePath": "", "kind": "discovery#restDescription", "baseUrl": "https://baremetalsolution.googleapis.com/", "id": "baremetalsolution:v2", "revision": "20260319", "batchPath": "batch", "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "ownerName": "Google", "schemas": { "Instance": { "id": "Instance", "type": "object", "description": "A server.", "properties": { "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. Update a time stamp.", "readOnly": true }, "workloadProfile": { "enum": [ "WORKLOAD_PROFILE_UNSPECIFIED", "WORKLOAD_PROFILE_GENERIC", "WORKLOAD_PROFILE_HANA" ], "type": "string", "enumDescriptions": [ "The workload profile is in an unknown state.", "The workload profile is generic.", "The workload profile is hana." ], "description": "The workload profile for the instance." }, "state": { "description": "Output only. The state of the server.", "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "RUNNING", "DELETED", "UPDATING", "STARTING", "STOPPING", "SHUTDOWN" ], "enumDescriptions": [ "The server is in an unknown state.", "The server is being provisioned.", "The server is running.", "The server has been deleted.", "The server is being updated.", "The server is starting.", "The server is stopping.", "The server is shutdown." ] }, "hyperthreadingEnabled": { "description": "True if you enable hyperthreading for the server, otherwise false. The default value is false.", "type": "boolean" }, "networkTemplate": { "type": "string", "description": "Instance network template name. For eg, bondaa-bondaa, bondab-nic, etc. Generally, the template name follows the syntax of \"bond\" or \"nic\"." }, "networks": { "items": { "$ref": "Network" }, "description": "Output only. List of networks associated with this server.", "readOnly": true, "type": "array" }, "interactiveSerialConsoleEnabled": { "type": "boolean", "description": "Output only. True if the interactive serial console feature is enabled for the instance, false otherwise. The default value is false.", "readOnly": true }, "osImage": { "description": "The OS image currently installed on the server.", "type": "string" }, "pod": { "type": "string", "description": "Immutable. Pod name. Pod is an independent part of infrastructure. Instance can only be connected to the assets (networks, volumes) allocated in the same pod." }, "firmwareVersion": { "type": "string", "description": "Output only. The firmware version for the instance.", "readOnly": true }, "logicalInterfaces": { "items": { "$ref": "GoogleCloudBaremetalsolutionV2LogicalInterface" }, "type": "array", "description": "List of logical interfaces for the instance. The number of logical interfaces will be the same as number of hardware bond/nic on the chosen network template. For the non-multivlan configurations (for eg, existing servers) that use existing default network template (bondaa-bondaa), both the Instance.networks field and the Instance.logical_interfaces fields will be filled to ensure backward compatibility. For the others, only Instance.logical_interfaces will be filled." }, "sshKeys": { "items": { "type": "string" }, "description": "Optional. List of SSH Keys used during instance provisioning.", "type": "array" }, "loginInfo": { "type": "string", "description": "Output only. Text field about info for logging in.", "readOnly": true }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Labels as key value pairs." }, "volumes": { "type": "array", "description": "Input only. List of Volumes to attach to this Instance on creation. This field won't be populated in Get/List responses.", "items": { "$ref": "Volume" } }, "machineType": { "description": "Immutable. The server type. [Available server types](https://cloud.google.com/bare-metal/docs/bms-planning#server_configurations)", "type": "string" }, "kmsKeyVersion": { "type": "string", "description": "Optional. Name of the KMS crypto key version used to encrypt the initial passwords. The key has to have ASYMMETRIC_DECRYPT purpose. Format is `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}/cryptoKeyVersions/{version}`." }, "id": { "description": "Output only. An identifier for the `Instance`, generated by the backend.", "readOnly": true, "type": "string" }, "createTime": { "format": "google-datetime", "description": "Output only. Create a time stamp.", "readOnly": true, "type": "string" }, "luns": { "items": { "$ref": "Lun" }, "type": "array", "description": "Immutable. List of LUNs associated with this server." }, "name": { "type": "string", "description": "Immutable. The resource name of this `Instance`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. Format: `projects/{project}/locations/{location}/instances/{instance}`" } } }, "RenameInstanceRequest": { "id": "RenameInstanceRequest", "type": "object", "description": "Message requesting rename of a server.", "properties": { "newInstanceId": { "type": "string", "description": "Required. The new `id` of the instance." } } }, "LunRange": { "id": "LunRange", "description": "A LUN(Logical Unit Number) range.", "properties": { "quantity": { "description": "Number of LUNs to create.", "type": "integer", "format": "int32" }, "sizeGb": { "type": "integer", "description": "The requested size of each LUN, in GB.", "format": "int32" } }, "type": "object" }, "ResetInstanceRequest": { "id": "ResetInstanceRequest", "type": "object", "description": "Message requesting to reset a server.", "properties": {} }, "StopInstanceRequest": { "description": "Message requesting to stop a server.", "properties": {}, "type": "object", "id": "StopInstanceRequest" }, "Network": { "id": "Network", "type": "object", "description": "A Network.", "properties": { "id": { "description": "An identifier for the `Network`, generated by the backend.", "type": "string" }, "ipAddress": { "description": "IP address configured.", "type": "string" }, "cidr": { "type": "string", "description": "The cidr of the Network." }, "type": { "enum": [ "TYPE_UNSPECIFIED", "CLIENT", "PRIVATE" ], "description": "The type of this network.", "type": "string", "enumDescriptions": [ "Unspecified value.", "Client network, a network peered to a Google Cloud VPC.", "Private network, a network local to the Bare Metal Solution environment." ] }, "name": { "type": "string", "description": "Output only. The resource name of this `Network`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. Format: `projects/{project}/locations/{location}/networks/{network}`", "readOnly": true }, "vrfAttachment": { "type": "string", "description": "Optional. The name of a pre-existing Vrf that the network should be attached to. Format is `vrfs/{vrf}`." }, "gatewayIp": { "type": "string", "description": "Output only. Gateway ip address.", "readOnly": true }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Labels as key value pairs." }, "vlanId": { "type": "string", "description": "The vlan id of the Network." }, "macAddress": { "items": { "type": "string" }, "type": "array", "description": "List of physical interfaces." }, "mountPoints": { "items": { "$ref": "NetworkMountPoint" }, "description": "Input only. List of mount points to attach the network to.", "type": "array" }, "pod": { "type": "string", "description": "Immutable. Pod name. Pod is an independent part of infrastructure. Network can only be connected to the assets (instances, nfsshares) allocated in the same pod." }, "vrf": { "$ref": "VRF", "description": "The Vrf for the Network. Use this only if a new Vrf needs to be created." }, "reservations": { "type": "array", "description": "List of IP address reservations in this network. When updating this field, an error will be generated if a reservation conflicts with an IP address already allocated to a physical server.", "items": { "$ref": "NetworkAddressReservation" } }, "jumboFramesEnabled": { "description": "Whether network uses standard frames or jumbo ones.", "type": "boolean" }, "state": { "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "PROVISIONED", "DEPROVISIONING", "UPDATING" ], "type": "string", "enumDescriptions": [ "The Network is in an unknown state.", "The Network is provisioning.", "The Network has been provisioned.", "The Network is being deprovisioned.", "The Network is being updated." ], "description": "The Network state." }, "servicesCidr": { "description": "IP range for reserved for services (e.g. NFS).", "type": "string" } } }, "ProvisioningConfig": { "id": "ProvisioningConfig", "type": "object", "description": "A provisioning configuration.", "properties": { "cloudConsoleUri": { "description": "Output only. URI to Cloud Console UI view of this provisioning config.", "readOnly": true, "type": "string" }, "ticketId": { "type": "string", "description": "A generated ticket id to track provisioning request." }, "statusMessage": { "description": "Optional status messages associated with the FAILED state.", "type": "string" }, "volumes": { "type": "array", "description": "Volumes to be created.", "items": { "$ref": "VolumeConfig" } }, "vpcScEnabled": { "description": "If true, VPC SC is enabled for the cluster.", "type": "boolean" }, "email": { "deprecated": true, "type": "string", "description": "Email provided to send a confirmation with provisioning config to. Deprecated in favour of email field in request messages." }, "name": { "description": "Output only. The system-generated name of the provisioning config. This follows the UUID format.", "readOnly": true, "type": "string" }, "customId": { "description": "Optional. The user-defined identifier of the provisioning config.", "type": "string" }, "handoverServiceAccount": { "description": "A service account to enable customers to access instance credentials upon handover.", "type": "string" }, "state": { "description": "Output only. State of ProvisioningConfig.", "readOnly": true, "type": "string", "enumDescriptions": [ "State wasn't specified.", "ProvisioningConfig is a draft and can be freely modified.", "ProvisioningConfig was already submitted and cannot be modified.", "ProvisioningConfig was in the provisioning state. Initially this state comes from the work order table in big query when SNOW is used. Later this field can be set by the work order API.", "ProvisioningConfig was provisioned, meaning the resources exist.", "ProvisioningConfig was validated. A validation tool will be run to set this state.", "ProvisioningConfig was canceled.", "The request is submitted for provisioning, with error return." ], "enum": [ "STATE_UNSPECIFIED", "DRAFT", "SUBMITTED", "PROVISIONING", "PROVISIONED", "VALIDATED", "CANCELLED", "FAILED" ] }, "instances": { "description": "Instances to be created.", "type": "array", "items": { "$ref": "InstanceConfig" } }, "updateTime": { "type": "string", "description": "Output only. Last update timestamp.", "readOnly": true, "format": "google-datetime" }, "networks": { "items": { "$ref": "NetworkConfig" }, "description": "Networks to be created.", "type": "array" }, "location": { "type": "string", "description": "Optional. Location name of this ProvisioningConfig. It is optional only for Intake UI transition period." }, "pod": { "type": "string", "description": "Optional. Pod name. Pod is an independent part of infrastructure. Instance can be connected to the assets (networks, volumes, nfsshares) allocated in the same pod only." } } }, "Lun": { "type": "object", "description": "A storage volume logical unit number (LUN).", "properties": { "id": { "description": "An identifier for the LUN, generated by the backend.", "type": "string" }, "storageVolume": { "type": "string", "description": "Display the storage volume for this LUN." }, "name": { "description": "Output only. The name of the LUN.", "readOnly": true, "type": "string" }, "shareable": { "description": "Display if this LUN can be shared between multiple physical servers.", "type": "boolean" }, "sizeGb": { "description": "The size of this LUN, in GiB.", "type": "string", "format": "int64" }, "storageType": { "enum": [ "STORAGE_TYPE_UNSPECIFIED", "SSD", "HDD" ], "type": "string", "enumDescriptions": [ "The storage type for this LUN is unknown.", "This storage type for this LUN is SSD.", "This storage type for this LUN is HDD." ], "description": "The storage type for this LUN." }, "wwid": { "type": "string", "description": "The WWID for this LUN." }, "state": { "type": "string", "enumDescriptions": [ "The LUN is in an unknown state.", "The LUN is being created.", "The LUN is being updated.", "The LUN is ready for use.", "The LUN has been requested to be deleted.", "The LUN is in cool off state. It will be deleted after `expire_time`." ], "description": "The state of this storage volume.", "enum": [ "STATE_UNSPECIFIED", "CREATING", "UPDATING", "READY", "DELETING", "COOL_OFF" ] }, "multiprotocolType": { "enum": [ "MULTIPROTOCOL_TYPE_UNSPECIFIED", "LINUX" ], "type": "string", "enumDescriptions": [ "Server has no OS specified.", "Server with Linux OS." ], "description": "The LUN multiprotocol type ensures the characteristics of the LUN are optimized for each operating system." }, "expireTime": { "format": "google-datetime", "type": "string", "description": "Output only. Time after which LUN will be fully deleted. It is filled only for LUNs in COOL_OFF state.", "readOnly": true }, "instances": { "items": { "type": "string" }, "description": "Output only. Instances this Lun is attached to.", "readOnly": true, "type": "array" }, "bootLun": { "type": "boolean", "description": "Display if this LUN is a boot LUN." } }, "id": "Lun" }, "ListProvisioningQuotasResponse": { "description": "Response message for the list of provisioning quotas.", "properties": { "nextPageToken": { "type": "string", "description": "Token to retrieve the next page of results, or empty if there are no more results in the list." }, "provisioningQuotas": { "items": { "$ref": "ProvisioningQuota" }, "description": "The provisioning quotas registered in this project.", "type": "array" } }, "type": "object", "id": "ListProvisioningQuotasResponse" }, "LogicalNetworkInterface": { "description": "Each logical network interface is effectively a network and IP pair.", "properties": { "defaultGateway": { "description": "Whether this interface is the default gateway for the instance. Only one interface can be the default gateway for the instance.", "type": "boolean" }, "id": { "type": "string", "description": "An identifier for the `Network`, generated by the backend." }, "network": { "description": "Name of the network", "type": "string" }, "ipAddress": { "type": "string", "description": "IP address in the network" }, "networkType": { "type": "string", "enumDescriptions": [ "Unspecified value.", "Client network, a network peered to a Google Cloud VPC.", "Private network, a network local to the Bare Metal Solution environment." ], "description": "Type of network.", "enum": [ "TYPE_UNSPECIFIED", "CLIENT", "PRIVATE" ] } }, "type": "object", "id": "LogicalNetworkInterface" }, "EvictVolumeRequest": { "id": "EvictVolumeRequest", "type": "object", "description": "Request for skip volume cooloff and delete it.", "properties": {} }, "RestoreVolumeSnapshotRequest": { "description": "Message for restoring a volume snapshot.", "properties": {}, "type": "object", "id": "RestoreVolumeSnapshotRequest" }, "VolumeConfig": { "id": "VolumeConfig", "type": "object", "description": "Configuration parameters for a new volume.", "properties": { "performanceTier": { "enum": [ "VOLUME_PERFORMANCE_TIER_UNSPECIFIED", "VOLUME_PERFORMANCE_TIER_SHARED", "VOLUME_PERFORMANCE_TIER_ASSIGNED", "VOLUME_PERFORMANCE_TIER_HT", "VOLUME_PERFORMANCE_TIER_QOS2_PERFORMANCE" ], "description": "Performance tier of the Volume. Default is SHARED.", "type": "string", "enumDescriptions": [ "Value is not specified.", "Regular volumes, shared aggregates.", "Assigned aggregates.", "High throughput aggregates.", "QoS 2.0 high performance storage." ] }, "protocol": { "enum": [ "PROTOCOL_UNSPECIFIED", "PROTOCOL_FC", "PROTOCOL_NFS" ], "description": "Volume protocol.", "type": "string", "enumDescriptions": [ "Unspecified value.", "Fibre channel.", "Network file system." ] }, "snapshotsEnabled": { "description": "Whether snapshots should be enabled.", "type": "boolean" }, "userNote": { "description": "User note field, it can be used by customers to add additional information for the BMS Ops team .", "type": "string" }, "sizeGb": { "format": "int32", "description": "The requested size of this volume, in GB.", "type": "integer" }, "nfsExports": { "items": { "$ref": "NfsExport" }, "description": "NFS exports. Set only when protocol is PROTOCOL_NFS.", "type": "array" }, "type": { "enum": [ "TYPE_UNSPECIFIED", "FLASH", "DISK" ], "type": "string", "enumDescriptions": [ "The unspecified type.", "This Volume is on flash.", "This Volume is on disk." ], "description": "The type of this Volume." }, "gcpService": { "type": "string", "description": "The GCP service of the storage volume. Available gcp_service are in https://cloud.google.com/bare-metal/docs/bms-planning." }, "name": { "description": "Output only. The name of the volume config.", "readOnly": true, "type": "string" }, "machineIds": { "description": "Machine ids connected to this volume. Set only when protocol is PROTOCOL_FC.", "type": "array", "items": { "type": "string" } }, "id": { "description": "A transient unique identifier to identify a volume within an ProvisioningConfig request.", "type": "string" }, "lunRanges": { "type": "array", "description": "LUN ranges to be configured. Set only when protocol is PROTOCOL_FC.", "items": { "$ref": "LunRange" } } } }, "ResetInstanceResponse": { "id": "ResetInstanceResponse", "type": "object", "description": "Response message from resetting a server.", "properties": {} }, "InstanceQuota": { "type": "object", "description": "A resource budget.", "properties": { "gcpService": { "type": "string", "description": "The gcp service of the provisioning quota." }, "name": { "type": "string", "description": "Output only. The name of the instance quota.", "readOnly": true }, "location": { "description": "Location where the quota applies.", "type": "string" }, "availableMachineCount": { "type": "integer", "description": "Number of machines than can be created for the given location and instance_type.", "format": "int32" }, "instanceType": { "description": "Instance type. Deprecated: use gcp_service.", "deprecated": true, "type": "string" } }, "id": "InstanceQuota" }, "GoogleCloudBaremetalsolutionV2ServerNetworkTemplateLogicalInterface": { "description": "Logical interface.", "properties": { "type": { "description": "Interface type.", "type": "string", "enumDescriptions": [ "Unspecified value.", "Bond interface type.", "NIC interface type." ], "enum": [ "INTERFACE_TYPE_UNSPECIFIED", "BOND", "NIC" ] }, "name": { "type": "string", "description": "Interface name. This is not a globally unique identifier. Name is unique only inside the ServerNetworkTemplate. This is of syntax or and forms part of the network template name." }, "required": { "type": "boolean", "description": "If true, interface must have network connected." } }, "type": "object", "id": "GoogleCloudBaremetalsolutionV2ServerNetworkTemplateLogicalInterface" }, "NetworkAddressReservation": { "type": "object", "description": "A reservation of one or more addresses in a network.", "properties": { "endAddress": { "description": "The last address of this reservation block, inclusive. I.e., for cases when reservations are only single addresses, end_address and start_address will be the same. Must be specified as a single IPv4 address, e.g. 10.1.2.2.", "type": "string" }, "startAddress": { "type": "string", "description": "The first address of this reservation block. Must be specified as a single IPv4 address, e.g. 10.1.2.2." }, "note": { "description": "A note about this reservation, intended for human consumption.", "type": "string" } }, "id": "NetworkAddressReservation" }, "ListNfsSharesResponse": { "id": "ListNfsSharesResponse", "description": "Response message containing the list of NFS shares.", "properties": { "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached.", "type": "array" }, "nfsShares": { "type": "array", "description": "The list of NFS shares.", "items": { "$ref": "NfsShare" } }, "nextPageToken": { "description": "A token identifying a page of results from the server.", "type": "string" } }, "type": "object" }, "ResizeVolumeRequest": { "id": "ResizeVolumeRequest", "description": "Request for emergency resize Volume.", "properties": { "sizeGib": { "format": "int64", "type": "string", "description": "New Volume size, in GiB." } }, "type": "object" }, "RenameVolumeRequest": { "id": "RenameVolumeRequest", "type": "object", "description": "Message requesting rename of a server.", "properties": { "newVolumeId": { "description": "Required. The new `id` of the volume.", "type": "string" } } }, "VRF": { "id": "VRF", "type": "object", "description": "A network VRF.", "properties": { "qosPolicy": { "$ref": "QosPolicy", "description": "The QOS policy applied to this VRF. The value is only meaningful when all the vlan attachments have the same QoS. This field should not be used for new integrations, use vlan attachment level qos instead. The field is left for backward-compatibility." }, "vlanAttachments": { "type": "array", "description": "The list of VLAN attachments for the VRF.", "items": { "$ref": "VlanAttachment" } }, "name": { "description": "The name of the VRF.", "type": "string" }, "state": { "description": "The possible state of VRF.", "type": "string", "enumDescriptions": [ "The unspecified state.", "The vrf is provisioning.", "The vrf is provisioned." ], "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "PROVISIONED" ] } } }, "ListLocationsResponse": { "type": "object", "description": "The response message for Locations.ListLocations.", "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Location" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "id": "ListLocationsResponse" }, "EvictLunRequest": { "id": "EvictLunRequest", "description": "Request for skip lun cooloff and delete it.", "properties": {}, "type": "object" }, "UserAccount": { "type": "object", "description": "User account provisioned for the customer.", "properties": { "encryptedPassword": { "description": "Encrypted initial password value.", "type": "string" }, "kmsKeyVersion": { "description": "KMS CryptoKey Version used to encrypt the password.", "type": "string" } }, "id": "UserAccount" }, "Status": { "id": "Status", "type": "object", "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": { "message": { "type": "string", "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." }, "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": { "format": "int32", "type": "integer", "description": "The status code, which should be an enum value of google.rpc.Code." } } }, "ListOSImagesResponse": { "type": "object", "description": "Request for getting all available OS images.", "properties": { "osImages": { "items": { "$ref": "OSImage" }, "type": "array", "description": "The OS images available." }, "nextPageToken": { "type": "string", "description": "Token to retrieve the next page of results, or empty if there are no more results in the list." } }, "id": "ListOSImagesResponse" }, "Volume": { "type": "object", "description": "A storage volume.", "properties": { "state": { "type": "string", "enumDescriptions": [ "The storage volume is in an unknown state.", "The storage volume is being created.", "The storage volume is ready for use.", "The storage volume has been requested to be deleted.", "The storage volume is being updated.", "The storage volume is in cool off state. It will be deleted after `expire_time`." ], "description": "The state of this storage volume.", "enum": [ "STATE_UNSPECIFIED", "CREATING", "READY", "DELETING", "UPDATING", "COOL_OFF" ] }, "requestedSizeGib": { "type": "string", "description": "The requested size of this storage volume, in GiB.", "format": "int64" }, "remainingSpaceGib": { "format": "int64", "description": "The space remaining in the storage volume for new LUNs, in GiB, excluding space reserved for snapshots.", "type": "string" }, "performanceTier": { "description": "Immutable. Performance tier of the Volume. Default is SHARED.", "type": "string", "enumDescriptions": [ "Value is not specified.", "Regular volumes, shared aggregates.", "Assigned aggregates.", "High throughput aggregates.", "QoS 2.0 high performance storage." ], "enum": [ "VOLUME_PERFORMANCE_TIER_UNSPECIFIED", "VOLUME_PERFORMANCE_TIER_SHARED", "VOLUME_PERFORMANCE_TIER_ASSIGNED", "VOLUME_PERFORMANCE_TIER_HT", "VOLUME_PERFORMANCE_TIER_QOS2_PERFORMANCE" ] }, "workloadProfile": { "enum": [ "WORKLOAD_PROFILE_UNSPECIFIED", "GENERIC", "HANA" ], "type": "string", "enumDescriptions": [ "The workload profile is in an unknown state.", "The workload profile is generic.", "The workload profile is hana." ], "description": "The workload profile for the volume." }, "expireTime": { "type": "string", "description": "Output only. Time after which volume will be fully deleted. It is filled only for volumes in COOLOFF state.", "readOnly": true, "format": "google-datetime" }, "instances": { "type": "array", "description": "Output only. Instances this Volume is attached to. This field is set only in Get requests.", "readOnly": true, "items": { "type": "string" } }, "currentSizeGib": { "type": "string", "description": "The current size of this storage volume, in GiB, including space reserved for snapshots. This size might be different than the requested size if the storage volume has been configured with auto grow or auto shrink.", "format": "int64" }, "emergencySizeGib": { "format": "int64", "description": "Additional emergency size that was requested for this Volume, in GiB. current_size_gib includes this value.", "type": "string" }, "storageType": { "description": "The storage type for this volume.", "type": "string", "enumDescriptions": [ "The storage type for this volume is unknown.", "The storage type for this volume is SSD.", "This storage type for this volume is HDD." ], "enum": [ "STORAGE_TYPE_UNSPECIFIED", "SSD", "HDD" ] }, "maxSizeGib": { "description": "Maximum size volume can be expanded to in case of evergency, in GiB.", "type": "string", "format": "int64" }, "pod": { "description": "Immutable. Pod name. Pod is an independent part of infrastructure. Volume can only be connected to the instances allocated in the same pod.", "type": "string" }, "autoGrownSizeGib": { "format": "int64", "description": "The size, in GiB, that this storage volume has expanded as a result of an auto grow policy. In the absence of auto-grow, the value is 0.", "type": "string" }, "labels": { "description": "Labels as key value pairs.", "type": "object", "additionalProperties": { "type": "string" } }, "originallyRequestedSizeGib": { "format": "int64", "type": "string", "description": "Originally requested size, in GiB." }, "bootVolume": { "type": "boolean", "description": "Output only. Whether this volume is a boot volume. A boot volume is one which contains a boot LUN.", "readOnly": true }, "protocol": { "description": "Output only. Storage protocol for the Volume.", "readOnly": true, "type": "string", "enumDescriptions": [ "Value is not specified.", "Fibre Channel protocol.", "NFS protocol means Volume is a NFS Share volume. Such volumes cannot be manipulated via Volumes API." ], "enum": [ "PROTOCOL_UNSPECIFIED", "FIBRE_CHANNEL", "NFS" ] }, "attached": { "description": "Output only. Is the Volume attached at at least one instance. This field is a lightweight counterpart of `instances` field. It is filled in List responses as well.", "readOnly": true, "type": "boolean" }, "snapshotReservationDetail": { "description": "Details about snapshot space reservation and usage on the storage volume.", "$ref": "SnapshotReservationDetail" }, "snapshotAutoDeleteBehavior": { "type": "string", "enumDescriptions": [ "The unspecified behavior.", "Don't delete any snapshots. This disables new snapshot creation, as long as the snapshot reserved space is full.", "Delete the oldest snapshots first.", "Delete the newest snapshots first." ], "description": "The behavior to use when snapshot reserved space is full.", "enum": [ "SNAPSHOT_AUTO_DELETE_BEHAVIOR_UNSPECIFIED", "DISABLED", "OLDEST_FIRST", "NEWEST_FIRST" ] }, "name": { "type": "string", "description": "Output only. The resource name of this `Volume`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. Format: `projects/{project}/locations/{location}/volumes/{volume}`", "readOnly": true }, "snapshotEnabled": { "type": "boolean", "description": "Whether snapshots are enabled." }, "id": { "type": "string", "description": "An identifier for the `Volume`, generated by the backend." }, "notes": { "description": "Input only. User-specified notes for new Volume. Used to provision Volumes that require manual intervention.", "type": "string" } }, "id": "Volume" }, "VolumeSnapshot": { "description": "A snapshot of a volume. Only boot volumes can have snapshots.", "properties": { "id": { "type": "string", "description": "Output only. An identifier for the snapshot, generated by the backend.", "readOnly": true }, "storageVolume": { "description": "Output only. The name of the volume which this snapshot belongs to.", "readOnly": true, "type": "string" }, "createTime": { "type": "string", "description": "Output only. The creation time of the snapshot.", "readOnly": true, "format": "google-datetime" }, "name": { "description": "The name of the snapshot.", "type": "string" }, "description": { "description": "The description of the snapshot.", "type": "string" }, "type": { "description": "Output only. The type of the snapshot which indicates whether it was scheduled or manual/ad-hoc.", "readOnly": true, "type": "string", "enumDescriptions": [ "Type is not specified.", "Snapshot was taken manually by user.", "Snapshot was taken automatically as a part of a snapshot schedule." ], "enum": [ "SNAPSHOT_TYPE_UNSPECIFIED", "AD_HOC", "SCHEDULED" ] } }, "type": "object", "id": "VolumeSnapshot" }, "SSHKey": { "type": "object", "description": "An SSH key, used for authorizing with the interactive serial console feature.", "properties": { "name": { "description": "Output only. The name of this SSH key. Currently, the only valid value for the location is \"global\".", "readOnly": true, "type": "string" }, "publicKey": { "description": "The public SSH key. This must be in OpenSSH .authorized_keys format.", "type": "string" } }, "id": "SSHKey" }, "ListNetworkUsageResponse": { "type": "object", "description": "Response with Networks with IPs", "properties": { "networks": { "type": "array", "description": "Networks with IPs.", "items": { "$ref": "NetworkUsage" } } }, "id": "ListNetworkUsageResponse" }, "Operation": { "id": "Operation", "type": "object", "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "error": { "$ref": "Status", "description": "The error result of the operation in case of failure or cancellation." }, "metadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "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." }, "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`.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "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}`." }, "done": { "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.", "type": "boolean" } } }, "StopInstanceResponse": { "id": "StopInstanceResponse", "type": "object", "description": "Response message from stopping a server.", "properties": {} }, "InstanceConfig": { "id": "InstanceConfig", "type": "object", "description": "Configuration parameters for a new instance.", "properties": { "logicalInterfaces": { "type": "array", "description": "List of logical interfaces for the instance. The number of logical interfaces will be the same as number of hardware bond/nic on the chosen network template. Filled if InstanceConfig.multivlan_config is true.", "items": { "$ref": "GoogleCloudBaremetalsolutionV2LogicalInterface" } }, "networkTemplate": { "description": "Server network template name. Filled if InstanceConfig.multivlan_config is true.", "type": "string" }, "instanceType": { "type": "string", "description": "Instance type. [Available types](https://cloud.google.com/bare-metal/docs/bms-planning#server_configurations)" }, "osImage": { "description": "OS image to initialize the instance. [Available images](https://cloud.google.com/bare-metal/docs/bms-planning#server_configurations)", "type": "string" }, "accountNetworksEnabled": { "type": "boolean", "description": "If true networks can be from different projects of the same vendor account." }, "hyperthreading": { "description": "Whether the instance should be provisioned with Hyperthreading enabled.", "type": "boolean" }, "userNote": { "type": "string", "description": "User note field, it can be used by customers to add additional information for the BMS Ops team ." }, "name": { "type": "string", "description": "The name of the instance config." }, "kmsKeyVersion": { "type": "string", "description": "Name of the KMS crypto key version used to encrypt the initial passwords. The key has to have ASYMMETRIC_DECRYPT purpose." }, "id": { "description": "A transient unique identifier to identify an instance within an ProvisioningConfig request.", "deprecated": true, "type": "string" }, "clientNetwork": { "description": "Client network address. Filled if InstanceConfig.multivlan_config is false.", "deprecated": true, "$ref": "NetworkAddress" }, "sshKeyNames": { "type": "array", "description": "Optional. List of names of ssh keys used to provision the instance.", "items": { "type": "string" } }, "privateNetwork": { "deprecated": true, "$ref": "NetworkAddress", "description": "Private network address, if any. Filled if InstanceConfig.multivlan_config is false." }, "networkConfig": { "type": "string", "enumDescriptions": [ "The unspecified network configuration.", "Instance part of single client network and single private network.", "Instance part of multiple (or single) client networks and private networks." ], "description": "The type of network configuration on the instance.", "enum": [ "NETWORKCONFIG_UNSPECIFIED", "SINGLE_VLAN", "MULTI_VLAN" ] } } }, "EnableInteractiveSerialConsoleResponse": { "description": "Message for response of EnableInteractiveSerialConsole.", "properties": {}, "type": "object", "id": "EnableInteractiveSerialConsoleResponse" }, "EnableInteractiveSerialConsoleRequest": { "description": "Message for enabling the interactive serial console on an instance.", "properties": {}, "type": "object", "id": "EnableInteractiveSerialConsoleRequest" }, "ListLunsResponse": { "id": "ListLunsResponse", "description": "Response message containing the list of storage volume luns.", "properties": { "nextPageToken": { "type": "string", "description": "A token identifying a page of results from the server." }, "luns": { "description": "The list of luns.", "type": "array", "items": { "$ref": "Lun" } }, "unreachable": { "items": { "type": "string" }, "type": "array", "description": "Locations that could not be reached." } }, "type": "object" }, "ReimageInstanceRequest": { "id": "ReimageInstanceRequest", "type": "object", "description": "Message requesting to perform reimage operation on a server.", "properties": { "osImage": { "type": "string", "description": "Required. The OS image code of the image which will be used in the reimage operation." }, "sshKeys": { "items": { "type": "string" }, "description": "Optional. List of SSH Keys used during reimaging an instance.", "type": "array" }, "kmsKeyVersion": { "description": "Optional. Name of the KMS crypto key version used to encrypt the initial passwords. The key has to have ASYMMETRIC_DECRYPT purpose. Format is `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}/cryptoKeyVersions/{version}`.", "type": "string" } } }, "IntakeVlanAttachment": { "id": "IntakeVlanAttachment", "description": "A GCP vlan attachment.", "properties": { "id": { "description": "Identifier of the VLAN attachment.", "type": "string" }, "pairingKey": { "description": "Attachment pairing key.", "type": "string" } }, "type": "object" }, "ListVolumeSnapshotsResponse": { "id": "ListVolumeSnapshotsResponse", "type": "object", "description": "Response message containing the list of volume snapshots.", "properties": { "unreachable": { "type": "array", "description": "Locations that could not be reached.", "items": { "type": "string" } }, "nextPageToken": { "description": "A token identifying a page of results from the server.", "type": "string" }, "volumeSnapshots": { "type": "array", "description": "The list of snapshots.", "items": { "$ref": "VolumeSnapshot" } } } }, "EnableHyperthreadingRequest": { "id": "EnableHyperthreadingRequest", "type": "object", "description": "Message requesting to perform enable hyperthreading operation on a server.", "properties": {} }, "DetachLunRequest": { "id": "DetachLunRequest", "description": "Message for detach specific LUN from an Instance.", "properties": { "lun": { "type": "string", "description": "Required. Name of the Lun to detach." }, "skipReboot": { "type": "boolean", "description": "If true, performs lun unmapping without instance reboot." } }, "type": "object" }, "ListNetworksResponse": { "type": "object", "description": "Response message containing the list of networks.", "properties": { "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } }, "networks": { "items": { "$ref": "Network" }, "type": "array", "description": "The list of networks." }, "nextPageToken": { "type": "string", "description": "A token identifying a page of results from the server." } }, "id": "ListNetworksResponse" }, "RenameNfsShareRequest": { "id": "RenameNfsShareRequest", "description": "Message requesting rename of a server.", "properties": { "newNfsshareId": { "type": "string", "description": "Required. The new `id` of the nfsshare." } }, "type": "object" }, "Location": { "type": "object", "description": "A resource that represents a Google Cloud location.", "properties": { "locationId": { "type": "string", "description": "The canonical id for this location. For example: `\"us-east1\"`." }, "name": { "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" }, "labels": { "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object", "additionalProperties": { "type": "string" } }, "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "metadata": { "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } } }, "id": "Location" }, "SubmitProvisioningConfigResponse": { "id": "SubmitProvisioningConfigResponse", "type": "object", "description": "Response for SubmitProvisioningConfig.", "properties": { "provisioningConfig": { "description": "The submitted provisioning config.", "$ref": "ProvisioningConfig" } } }, "DisableInteractiveSerialConsoleResponse": { "description": "Message for response of DisableInteractiveSerialConsole.", "properties": {}, "type": "object", "id": "DisableInteractiveSerialConsoleResponse" }, "NetworkMountPoint": { "id": "NetworkMountPoint", "description": "Mount point for a network.", "properties": { "instance": { "description": "Instance to attach network to.", "type": "string" }, "logicalInterface": { "description": "Logical interface to detach from.", "type": "string" }, "defaultGateway": { "description": "Network should be a default gateway.", "type": "boolean" }, "ipAddress": { "description": "Ip address of the server.", "type": "string" } }, "type": "object" }, "NetworkConfig": { "type": "object", "description": "Configuration parameters for a new network.", "properties": { "id": { "description": "A transient unique identifier to identify a volume within an ProvisioningConfig request.", "type": "string" }, "serviceCidr": { "enum": [ "SERVICE_CIDR_UNSPECIFIED", "DISABLED", "HIGH_26", "HIGH_27", "HIGH_28" ], "type": "string", "enumDescriptions": [ "Unspecified value.", "Services are disabled for the given network.", "Use the highest /26 block of the network to host services.", "Use the highest /27 block of the network to host services.", "Use the highest /28 block of the network to host services." ], "description": "Service CIDR, if any." }, "cidr": { "type": "string", "description": "CIDR range of the network." }, "vrf": { "description": "Optional. The name of a pre-existing Vrf that the network should be attached to. Format is `vrfs/{vrf}`. If vrf is specified, vlan_attachments must be empty.", "type": "string" }, "vlanSameProject": { "description": "Whether the VLAN attachment pair is located in the same project.", "type": "boolean" }, "type": { "enum": [ "TYPE_UNSPECIFIED", "CLIENT", "PRIVATE" ], "description": "The type of this network, either Client or Private.", "type": "string", "enumDescriptions": [ "Unspecified value.", "Client network, that is a network peered to a GCP VPC.", "Private network, that is a network local to the BMS POD." ] }, "gcpService": { "description": "The GCP service of the network. Available gcp_service are in https://cloud.google.com/bare-metal/docs/bms-planning.", "type": "string" }, "name": { "type": "string", "description": "Output only. The name of the network config.", "readOnly": true }, "bandwidth": { "enum": [ "BANDWIDTH_UNSPECIFIED", "BW_1_GBPS", "BW_2_GBPS", "BW_5_GBPS", "BW_10_GBPS" ], "description": "Interconnect bandwidth. Set only when type is CLIENT.", "type": "string", "enumDescriptions": [ "Unspecified value.", "1 Gbps.", "2 Gbps.", "5 Gbps.", "10 Gbps." ] }, "userNote": { "type": "string", "description": "User note field, it can be used by customers to add additional information for the BMS Ops team ." }, "vlanAttachments": { "items": { "$ref": "IntakeVlanAttachment" }, "description": "List of VLAN attachments. As of now there are always 2 attachments, but it is going to change in the future (multi vlan). Use only one of vlan_attachments or vrf", "type": "array" }, "jumboFramesEnabled": { "type": "boolean", "description": "The JumboFramesEnabled option for customer to set." } }, "id": "NetworkConfig" }, "Empty": { "id": "Empty", "type": "object", "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "properties": {} }, "NetworkUsage": { "id": "NetworkUsage", "type": "object", "description": "Network with all used IP addresses.", "properties": { "network": { "$ref": "Network", "description": "Network." }, "usedIps": { "description": "All used IP addresses in this network.", "type": "array", "items": { "type": "string" } } } }, "ProvisioningQuota": { "id": "ProvisioningQuota", "type": "object", "description": "A provisioning quota for a given project.", "properties": { "name": { "type": "string", "description": "Output only. The name of the provisioning quota.", "readOnly": true }, "gcpService": { "type": "string", "description": "The gcp service of the provisioning quota." }, "availableCount": { "format": "int32", "type": "integer", "description": "The available count of the provisioning quota." }, "location": { "description": "The specific location of the provisioining quota.", "type": "string" }, "serverCount": { "format": "int64", "type": "string", "description": "Server count." }, "storageGib": { "type": "string", "description": "Storage size (GB).", "format": "int64" }, "assetType": { "enum": [ "ASSET_TYPE_UNSPECIFIED", "ASSET_TYPE_SERVER", "ASSET_TYPE_STORAGE", "ASSET_TYPE_NETWORK" ], "type": "string", "enumDescriptions": [ "The unspecified type.", "The server asset type.", "The storage asset type.", "The network asset type." ], "description": "The asset type of this provisioning quota." }, "instanceQuota": { "description": "Instance quota.", "$ref": "InstanceQuota" }, "networkBandwidth": { "type": "string", "description": "Network bandwidth, Gbps", "format": "int64" } } }, "VlanAttachment": { "id": "VlanAttachment", "description": "VLAN attachment details.", "properties": { "peerVlanId": { "format": "int64", "type": "string", "description": "The peer vlan ID of the attachment." }, "routerIp": { "type": "string", "description": "The router IP of the attachment." }, "peerIp": { "type": "string", "description": "The peer IP of the attachment." }, "qosPolicy": { "description": "The QOS policy applied to this VLAN attachment. This value should be preferred to using qos at vrf level.", "$ref": "QosPolicy" }, "interconnectAttachment": { "description": "Optional. The name of the vlan attachment within vrf. This is of the form projects/{project_number}/regions/{region}/interconnectAttachments/{interconnect_attachment}", "type": "string" }, "pairingKey": { "type": "string", "description": "Input only. Pairing key." }, "id": { "type": "string", "description": "Immutable. The identifier of the attachment within vrf." } }, "type": "object" }, "ServerNetworkTemplate": { "id": "ServerNetworkTemplate", "type": "object", "description": "Network template.", "properties": { "applicableInstanceTypes": { "items": { "type": "string" }, "description": "Instance types this template is applicable to.", "type": "array" }, "logicalInterfaces": { "items": { "$ref": "GoogleCloudBaremetalsolutionV2ServerNetworkTemplateLogicalInterface" }, "description": "Logical interfaces.", "type": "array" }, "name": { "description": "Output only. Template's unique name. The full resource name follows the pattern: `projects/{project}/locations/{location}/serverNetworkTemplate/{server_network_template}` Generally, the {server_network_template} follows the syntax of \"bond\" or \"nic\".", "readOnly": true, "type": "string" } } }, "RenameNetworkRequest": { "id": "RenameNetworkRequest", "type": "object", "description": "Message requesting rename of a server.", "properties": { "newNetworkId": { "type": "string", "description": "Required. The new `id` of the network." } } }, "QosPolicy": { "type": "object", "description": "QOS policy parameters.", "properties": { "bandwidthGbps": { "format": "double", "description": "The bandwidth permitted by the QOS policy, in gbps.", "type": "number" } }, "id": "QosPolicy" }, "StartInstanceResponse": { "id": "StartInstanceResponse", "type": "object", "description": "Response message from starting a server.", "properties": {} }, "GoogleCloudBaremetalsolutionV2LogicalInterface": { "id": "GoogleCloudBaremetalsolutionV2LogicalInterface", "description": "Each logical interface represents a logical abstraction of the underlying physical interface (for eg. bond, nic) of the instance. Each logical interface can effectively map to multiple network-IP pairs and still be mapped to one underlying physical interface.", "properties": { "name": { "description": "Interface name. This is of syntax or and forms part of the network template name.", "type": "string" }, "interfaceIndex": { "description": "The index of the logical interface mapping to the index of the hardware bond or nic on the chosen network template. This field is deprecated.", "deprecated": true, "type": "integer", "format": "int32" }, "logicalNetworkInterfaces": { "description": "List of logical network interfaces within a logical interface.", "type": "array", "items": { "$ref": "LogicalNetworkInterface" } } }, "type": "object" }, "LoadInstanceAuthInfoResponse": { "description": "Response for LoadInstanceAuthInfo.", "properties": { "userAccounts": { "type": "object", "additionalProperties": { "$ref": "UserAccount" }, "description": "Map of username to the user account info." }, "sshKeys": { "description": "List of ssh keys.", "type": "array", "items": { "$ref": "SSHKey" } } }, "type": "object", "id": "LoadInstanceAuthInfoResponse" }, "OSImage": { "type": "object", "description": "Operation System image.", "properties": { "supportedNetworkTemplates": { "type": "array", "description": "Network templates that can be used with this OS Image.", "items": { "type": "string" } }, "name": { "type": "string", "description": "Output only. OS Image's unique name.", "readOnly": true }, "description": { "type": "string", "description": "OS Image description." }, "applicableInstanceTypes": { "type": "array", "description": "Instance types this image is applicable to. [Available types](https://cloud.google.com/bare-metal/docs/bms-planning#server_configurations)", "items": { "type": "string" } }, "code": { "description": "OS Image code.", "type": "string" } }, "id": "OSImage" }, "DisableHyperthreadingRequest": { "id": "DisableHyperthreadingRequest", "description": "Message requesting to perform disable hyperthreading operation on a server.", "properties": {}, "type": "object" }, "ListVolumesResponse": { "id": "ListVolumesResponse", "description": "Response message containing the list of storage volumes.", "properties": { "volumes": { "items": { "$ref": "Volume" }, "type": "array", "description": "The list of storage volumes." }, "nextPageToken": { "description": "A token identifying a page of results from the server.", "type": "string" }, "unreachable": { "items": { "type": "string" }, "type": "array", "description": "Locations that could not be reached." } }, "type": "object" }, "NfsExport": { "type": "object", "description": "A NFS export entry.", "properties": { "noRootSquash": { "description": "Disable root squashing, which is a feature of NFS. Root squash is a special mapping of the remote superuser (root) identity when using identity authentication.", "type": "boolean" }, "machineId": { "description": "Either a single machine, identified by an ID, or a comma-separated list of machine IDs.", "type": "string" }, "allowSuid": { "description": "Allow the setuid flag.", "type": "boolean" }, "permissions": { "type": "string", "enumDescriptions": [ "Unspecified value.", "Read-only permission.", "Read-write permission." ], "description": "Export permissions.", "enum": [ "PERMISSIONS_UNSPECIFIED", "READ_ONLY", "READ_WRITE" ] }, "allowDev": { "type": "boolean", "description": "Allow dev flag in NfsShare AllowedClientsRequest." }, "networkId": { "type": "string", "description": "Network to use to publish the export." }, "cidr": { "type": "string", "description": "A CIDR range." } }, "id": "NfsExport" }, "ListInstancesResponse": { "description": "Response message for the list of servers.", "properties": { "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } }, "instances": { "type": "array", "description": "The list of servers.", "items": { "$ref": "Instance" } }, "nextPageToken": { "description": "A token identifying a page of results from the server.", "type": "string" } }, "type": "object", "id": "ListInstancesResponse" }, "DisableInteractiveSerialConsoleRequest": { "description": "Message for disabling the interactive serial console on an instance.", "properties": {}, "type": "object", "id": "DisableInteractiveSerialConsoleRequest" }, "NetworkAddress": { "id": "NetworkAddress", "type": "object", "description": "A network.", "properties": { "address": { "type": "string", "description": "IPv4 address to be assigned to the server." }, "existingNetworkId": { "type": "string", "description": "Name of the existing network to use." }, "networkId": { "description": "Id of the network to use, within the same ProvisioningConfig request.", "type": "string" } } }, "SnapshotReservationDetail": { "id": "SnapshotReservationDetail", "description": "Details about snapshot space reservation and usage on the storage volume.", "properties": { "reservedSpaceGib": { "description": "The space on this storage volume reserved for snapshots, shown in GiB.", "type": "string", "format": "int64" }, "reservedSpaceRemainingGib": { "description": "The amount, in GiB, of available space in this storage volume's reserved snapshot space.", "type": "string", "format": "int64" }, "reservedSpaceUsedPercent": { "description": "The percent of snapshot space on this storage volume actually being used by the snapshot copies. This value might be higher than 100% if the snapshot copies have overflowed into the data portion of the storage volume.", "type": "integer", "format": "int32" }, "reservedSpacePercent": { "format": "int32", "description": "Percent of the total Volume size reserved for snapshot copies. Enabling snapshots requires reserving 20% or more of the storage volume space for snapshots. Maximum reserved space for snapshots is 40%. Setting this field will effectively set snapshot_enabled to true.", "type": "integer" } }, "type": "object" }, "SubmitProvisioningConfigRequest": { "description": "Request for SubmitProvisioningConfig.", "properties": { "provisioningConfig": { "$ref": "ProvisioningConfig", "description": "Required. The ProvisioningConfig to create." }, "email": { "description": "Optional. Email provided to send a confirmation with provisioning config to.", "type": "string" } }, "type": "object", "id": "SubmitProvisioningConfigRequest" }, "StartInstanceRequest": { "type": "object", "description": "Message requesting to start a server.", "properties": {}, "id": "StartInstanceRequest" }, "NfsShare": { "id": "NfsShare", "description": "An NFS share.", "properties": { "volume": { "description": "Output only. The underlying volume of the share. Created automatically during provisioning.", "readOnly": true, "type": "string" }, "state": { "enumDescriptions": [ "The share is in an unknown state.", "The share has been provisioned.", "The NFS Share is being created.", "The NFS Share is being updated.", "The NFS Share has been requested to be deleted." ], "enum": [ "STATE_UNSPECIFIED", "PROVISIONED", "CREATING", "UPDATING", "DELETING" ], "type": "string", "description": "Output only. The state of the NFS share.", "readOnly": true }, "requestedSizeGib": { "format": "int64", "type": "string", "description": "The requested size, in GiB." }, "nfsShareId": { "type": "string", "description": "Output only. An identifier for the NFS share, generated by the backend. This field will be deprecated in the future, use `id` instead.", "readOnly": true }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Labels as key value pairs." }, "name": { "type": "string", "description": "Immutable. The name of the NFS share." }, "allowedClients": { "description": "List of allowed access points.", "type": "array", "items": { "$ref": "AllowedClient" } }, "storageType": { "type": "string", "enumDescriptions": [ "The storage type for this volume is unknown.", "The storage type for this volume is SSD.", "This storage type for this volume is HDD." ], "description": "Immutable. The storage type of the underlying volume.", "enum": [ "STORAGE_TYPE_UNSPECIFIED", "SSD", "HDD" ] }, "pod": { "description": "Immutable. Pod name. Pod is an independent part of infrastructure. NFSShare can only be connected to the assets (networks, instances) allocated in the same pod.", "type": "string" }, "id": { "type": "string", "description": "Output only. An identifier for the NFS share, generated by the backend. This is the same value as nfs_share_id and will replace it in the future.", "readOnly": true } }, "type": "object" }, "ListSSHKeysResponse": { "id": "ListSSHKeysResponse", "description": "Message for response of ListSSHKeys.", "properties": { "sshKeys": { "description": "The SSH keys registered in the project.", "type": "array", "items": { "$ref": "SSHKey" } }, "nextPageToken": { "type": "string", "description": "Token to retrieve the next page of results, or empty if there are no more results in the list." } }, "type": "object" }, "AllowedClient": { "id": "AllowedClient", "description": "Represents an 'access point' for the share.", "properties": { "allowedClientsCidr": { "description": "The subnet of IP addresses permitted to access the share.", "type": "string" }, "allowSuid": { "type": "boolean", "description": "Allow the setuid flag." }, "noRootSquash": { "type": "boolean", "description": "Disable root squashing, which is a feature of NFS. Root squash is a special mapping of the remote superuser (root) identity when using identity authentication." }, "nfsPath": { "description": "Output only. The path to access NFS, in format shareIP:/InstanceID InstanceID is the generated ID instead of customer provided name. example like \"10.0.0.0:/g123456789-nfs001\"", "readOnly": true, "type": "string" }, "network": { "description": "The network the access point sits on.", "type": "string" }, "shareIp": { "description": "Output only. The IP address of the share on this network. Assigned automatically during provisioning based on the network's services_cidr.", "readOnly": true, "type": "string" }, "mountPermissions": { "description": "Mount permissions.", "type": "string", "enumDescriptions": [ "Permissions were not specified.", "NFS share can be mount with read-only permissions.", "NFS share can be mount with read-write permissions." ], "enum": [ "MOUNT_PERMISSIONS_UNSPECIFIED", "READ", "READ_WRITE" ] }, "allowDev": { "description": "Allow dev flag. Which controls whether to allow creation of devices.", "type": "boolean" } }, "type": "object" } }, "basePath": "", "title": "Bare Metal Solution API", "discoveryVersion": "v1", "fullyEncodeReservedExpansion": true, "name": "baremetalsolution", "description": "Provides ways to manage Bare Metal Solution hardware installed in a regional extension located near a Google Cloud data center.", "auth": { "oauth2": { "scopes": { "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." } } } }, "rootUrl": "https://baremetalsolution.googleapis.com/", "mtlsRootUrl": "https://baremetalsolution.mtls.googleapis.com/", "protocol": "rest", "resources": { "projects": { "resources": { "locations": { "methods": { "list": { "response": { "$ref": "ListLocationsResponse" }, "parameters": { "name": { "required": true, "description": "The resource that owns the locations collection, if applicable.", "type": "string", "location": "path", "pattern": "^projects/[^/]+$" }, "extraLocationTypes": { "repeated": true, "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "description": "The maximum number of results to return. If not set, the service selects a default.", "location": "query", "type": "integer" }, "pageToken": { "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query", "type": "string" }, "filter": { "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}/locations", "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the [ListLocationsRequest.name] field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", "httpMethod": "GET", "flatPath": "v2/projects/{projectsId}/locations", "id": "baremetalsolution.projects.locations.list" }, "get": { "description": "Gets information about a location.", "httpMethod": "GET", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}", "id": "baremetalsolution.projects.locations.get", "response": { "$ref": "Location" }, "path": "v2/{+name}", "parameters": { "name": { "required": true, "description": "Resource name for the location.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "instances": { "methods": { "rename": { "response": { "$ref": "Instance" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path", "type": "string", "description": "Required. The `name` field is used to identify the instance. Format: projects/{project}/locations/{location}/instances/{instance}", "required": true } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "RenameInstanceRequest" }, "path": "v2/{+name}:rename", "description": "RenameInstance sets a new name for an instance. Use with caution, previous names become immediately invalidated.", "httpMethod": "POST", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:rename", "id": "baremetalsolution.projects.locations.instances.rename" }, "disableHyperthreading": { "response": { "$ref": "Operation" }, "parameters": { "name": { "required": true, "type": "string", "description": "Required. The `name` field is used to identify the instance. Format: projects/{project}/locations/{location}/instances/{instance}", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "DisableHyperthreadingRequest" }, "path": "v2/{+name}:disableHyperthreading", "description": "Perform disable hyperthreading operation on a single server.", "httpMethod": "POST", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:disableHyperthreading", "id": "baremetalsolution.projects.locations.instances.disableHyperthreading" }, "patch": { "path": "v2/{+name}", "request": { "$ref": "Instance" }, "parameters": { "name": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "description": "Immutable. The resource name of this `Instance`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. Format: `projects/{project}/locations/{location}/instances/{instance}`", "type": "string", "required": true }, "updateMask": { "format": "google-fieldmask", "description": "The list of fields to update. The currently supported fields are: `labels` `hyperthreading_enabled` `os_image` `ssh_keys` `kms_key_version`", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "id": "baremetalsolution.projects.locations.instances.patch", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}", "httpMethod": "PATCH", "description": "Update details of a single server." }, "get": { "parameters": { "name": { "required": true, "type": "string", "description": "Required. Name of the resource.", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}", "response": { "$ref": "Instance" }, "id": "baremetalsolution.projects.locations.instances.get", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}", "httpMethod": "GET", "description": "Get details about a single server." }, "disableInteractiveSerialConsole": { "parameters": { "name": { "description": "Required. Name of the resource.", "type": "string", "required": true, "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "DisableInteractiveSerialConsoleRequest" }, "path": "v2/{+name}:disableInteractiveSerialConsole", "response": { "$ref": "Operation" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:disableInteractiveSerialConsole", "id": "baremetalsolution.projects.locations.instances.disableInteractiveSerialConsole", "description": "Disable the interactive serial console feature on an instance.", "httpMethod": "POST" }, "detachLun": { "request": { "$ref": "DetachLunRequest" }, "parameters": { "instance": { "description": "Required. Name of the instance.", "type": "string", "required": true, "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$" } }, "parameterOrder": [ "instance" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+instance}:detachLun", "response": { "$ref": "Operation" }, "id": "baremetalsolution.projects.locations.instances.detachLun", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:detachLun", "httpMethod": "POST", "description": "Detach LUN from Instance." }, "enableInteractiveSerialConsole": { "httpMethod": "POST", "description": "Enable the interactive serial console feature on an instance.", "id": "baremetalsolution.projects.locations.instances.enableInteractiveSerialConsole", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:enableInteractiveSerialConsole", "response": { "$ref": "Operation" }, "request": { "$ref": "EnableInteractiveSerialConsoleRequest" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. Name of the resource." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}:enableInteractiveSerialConsole" }, "reset": { "path": "v2/{+name}:reset", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. Name of the resource." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "ResetInstanceRequest" }, "response": { "$ref": "Operation" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:reset", "id": "baremetalsolution.projects.locations.instances.reset", "description": "Perform an ungraceful, hard reset on a server. Equivalent to shutting the power off and then turning it back on.", "httpMethod": "POST" }, "list": { "httpMethod": "GET", "description": "List servers in a given project and location.", "id": "baremetalsolution.projects.locations.instances.list", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances", "response": { "$ref": "ListInstancesResponse" }, "parameters": { "filter": { "type": "string", "description": "List filter.", "location": "query" }, "pageSize": { "format": "int32", "description": "Requested page size. Server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "location": "query", "type": "integer" }, "pageToken": { "description": "A token identifying a page of results from the server.", "location": "query", "type": "string" }, "parent": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. Parent value for ListInstancesRequest.", "type": "string", "required": true } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/instances" }, "reimage": { "response": { "$ref": "Operation" }, "parameters": { "name": { "required": true, "type": "string", "description": "Required. The `name` field is used to identify the instance. Format: projects/{project}/locations/{location}/instances/{instance}", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "ReimageInstanceRequest" }, "path": "v2/{+name}:reimage", "description": "Perform reimage operation on a single server.", "httpMethod": "POST", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:reimage", "id": "baremetalsolution.projects.locations.instances.reimage" }, "start": { "path": "v2/{+name}:start", "parameters": { "name": { "type": "string", "description": "Required. Name of the resource.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "StartInstanceRequest" }, "response": { "$ref": "Operation" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:start", "id": "baremetalsolution.projects.locations.instances.start", "description": "Starts a server that was shutdown.", "httpMethod": "POST" }, "stop": { "id": "baremetalsolution.projects.locations.instances.stop", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:stop", "httpMethod": "POST", "description": "Stop a running server.", "request": { "$ref": "StopInstanceRequest" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path", "type": "string", "description": "Required. Name of the resource.", "required": true } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}:stop", "response": { "$ref": "Operation" } }, "loadAuthInfo": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. Name of the server." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}:loadAuthInfo", "response": { "$ref": "LoadInstanceAuthInfoResponse" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:loadAuthInfo", "id": "baremetalsolution.projects.locations.instances.loadAuthInfo", "description": "Load auth info for a server.", "httpMethod": "GET" }, "enableHyperthreading": { "id": "baremetalsolution.projects.locations.instances.enableHyperthreading", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:enableHyperthreading", "httpMethod": "POST", "description": "Perform enable hyperthreading operation on a single server.", "request": { "$ref": "EnableHyperthreadingRequest" }, "parameters": { "name": { "type": "string", "description": "Required. The `name` field is used to identify the instance. Format: projects/{project}/locations/{location}/instances/{instance}", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}:enableHyperthreading", "response": { "$ref": "Operation" } } } }, "volumes": { "methods": { "list": { "parameters": { "filter": { "description": "List filter.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "description": "A token identifying a page of results from the server.", "location": "query" }, "parent": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. Parent value for ListVolumesRequest.", "type": "string", "required": true } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/volumes", "response": { "$ref": "ListVolumesResponse" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes", "id": "baremetalsolution.projects.locations.volumes.list", "description": "List storage volumes in a given project and location.", "httpMethod": "GET" }, "patch": { "description": "Update details of a single storage volume.", "httpMethod": "PATCH", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}", "id": "baremetalsolution.projects.locations.volumes.patch", "response": { "$ref": "Operation" }, "path": "v2/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Output only. The resource name of this `Volume`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. Format: `projects/{project}/locations/{location}/volumes/{volume}`" }, "updateMask": { "type": "string", "description": "The list of fields to update. The only currently supported fields are: 'labels'", "location": "query", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "Volume" } }, "rename": { "httpMethod": "POST", "description": "RenameVolume sets a new name for a volume. Use with caution, previous names become immediately invalidated.", "id": "baremetalsolution.projects.locations.volumes.rename", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}:rename", "response": { "$ref": "Volume" }, "path": "v2/{+name}:rename", "request": { "$ref": "RenameVolumeRequest" }, "parameters": { "name": { "required": true, "type": "string", "description": "Required. The `name` field is used to identify the volume. Format: projects/{project}/locations/{location}/volumes/{volume}", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "evict": { "response": { "$ref": "Operation" }, "path": "v2/{+name}:evict", "request": { "$ref": "EvictVolumeRequest" }, "parameters": { "name": { "required": true, "description": "Required. The name of the Volume.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Skips volume's cooloff and deletes it now. Volume must be in cooloff state.", "id": "baremetalsolution.projects.locations.volumes.evict", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}:evict" }, "get": { "httpMethod": "GET", "description": "Get details of a single storage volume.", "id": "baremetalsolution.projects.locations.volumes.get", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}", "response": { "$ref": "Volume" }, "parameters": { "name": { "required": true, "type": "string", "description": "Required. Name of the resource.", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}" }, "resize": { "httpMethod": "POST", "description": "Emergency Volume resize.", "id": "baremetalsolution.projects.locations.volumes.resize", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}:resize", "response": { "$ref": "Operation" }, "request": { "$ref": "ResizeVolumeRequest" }, "parameters": { "volume": { "required": true, "description": "Required. Volume to resize.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$" } }, "parameterOrder": [ "volume" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+volume}:resize" } }, "resources": { "snapshots": { "methods": { "delete": { "response": { "$ref": "Empty" }, "parameters": { "name": { "required": true, "type": "string", "description": "Required. The name of the snapshot to delete.", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/snapshots/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}", "httpMethod": "DELETE", "description": "Deletes a volume snapshot. Returns INVALID_ARGUMENT if called for a non-boot volume.", "id": "baremetalsolution.projects.locations.volumes.snapshots.delete", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots/{snapshotsId}" }, "restoreVolumeSnapshot": { "id": "baremetalsolution.projects.locations.volumes.snapshots.restoreVolumeSnapshot", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots/{snapshotsId}:restoreVolumeSnapshot", "httpMethod": "POST", "description": "Uses the specified snapshot to restore its parent volume. Returns INVALID_ARGUMENT if called for a non-boot volume.", "path": "v2/{+volumeSnapshot}:restoreVolumeSnapshot", "request": { "$ref": "RestoreVolumeSnapshotRequest" }, "parameters": { "volumeSnapshot": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/snapshots/[^/]+$", "description": "Required. Name of the snapshot which will be used to restore its parent volume.", "type": "string", "required": true } }, "parameterOrder": [ "volumeSnapshot" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" } }, "get": { "description": "Returns the specified snapshot resource. Returns INVALID_ARGUMENT if called for a non-boot volume.", "httpMethod": "GET", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots/{snapshotsId}", "id": "baremetalsolution.projects.locations.volumes.snapshots.get", "response": { "$ref": "VolumeSnapshot" }, "path": "v2/{+name}", "parameters": { "name": { "description": "Required. The name of the snapshot.", "type": "string", "required": true, "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/snapshots/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "httpMethod": "POST", "description": "Takes a snapshot of a boot volume. Returns INVALID_ARGUMENT if called for a non-boot volume.", "id": "baremetalsolution.projects.locations.volumes.snapshots.create", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots", "response": { "$ref": "VolumeSnapshot" }, "request": { "$ref": "VolumeSnapshot" }, "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The volume to snapshot." } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/snapshots" }, "list": { "response": { "$ref": "ListVolumeSnapshotsResponse" }, "parameters": { "pageSize": { "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A token identifying a page of results from the server.", "location": "query", "type": "string" }, "parent": { "required": true, "description": "Required. Parent value for ListVolumesRequest.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/snapshots", "httpMethod": "GET", "description": "Retrieves the list of snapshots for the specified volume. Returns a response with an empty list of snapshots if called for a non-boot volume.", "id": "baremetalsolution.projects.locations.volumes.snapshots.list", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots" } } }, "luns": { "methods": { "list": { "response": { "$ref": "ListLunsResponse" }, "path": "v2/{+parent}/luns", "parameters": { "pageSize": { "type": "integer", "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "A token identifying a page of results from the server.", "location": "query" }, "parent": { "description": "Required. Parent value for ListLunsRequest.", "type": "string", "required": true, "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "List storage volume luns for given storage volume.", "id": "baremetalsolution.projects.locations.volumes.luns.list", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/luns" }, "evict": { "response": { "$ref": "Operation" }, "parameters": { "name": { "required": true, "description": "Required. The name of the lun.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/luns/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "EvictLunRequest" }, "path": "v2/{+name}:evict", "description": "Skips lun's cooloff and deletes it now. Lun must be in cooloff state.", "httpMethod": "POST", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/luns/{lunsId}:evict", "id": "baremetalsolution.projects.locations.volumes.luns.evict" }, "get": { "id": "baremetalsolution.projects.locations.volumes.luns.get", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/luns/{lunsId}", "httpMethod": "GET", "description": "Get details of a single storage logical unit number(LUN).", "parameters": { "name": { "required": true, "type": "string", "description": "Required. Name of the resource.", "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/luns/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}", "response": { "$ref": "Lun" } } } } } }, "osImages": { "methods": { "list": { "response": { "$ref": "ListOSImagesResponse" }, "path": "v2/{+parent}/osImages", "parameters": { "pageSize": { "format": "int32", "type": "integer", "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default. Notice that page_size field is not supported and won't be respected in the API request for now, will be updated when pagination is supported.", "location": "query" }, "pageToken": { "description": "A token identifying a page of results from the server.", "location": "query", "type": "string" }, "parent": { "type": "string", "description": "Required. Parent value for ListOSImagesRequest.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieves the list of OS images which are currently approved.", "httpMethod": "GET", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/osImages", "id": "baremetalsolution.projects.locations.osImages.list" }, "get": { "description": "Get details of a single OS image.", "httpMethod": "GET", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/osImages/{osImagesId}", "id": "baremetalsolution.projects.locations.osImages.get", "response": { "$ref": "OSImage" }, "path": "v2/{+name}", "parameters": { "name": { "description": "Required. Name of the OS image.", "type": "string", "required": true, "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/osImages/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "provisioningConfigs": { "methods": { "submit": { "parameters": { "parent": { "required": true, "description": "Required. The parent project and location containing the ProvisioningConfig.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "SubmitProvisioningConfigRequest" }, "path": "v2/{+parent}/provisioningConfigs:submit", "response": { "$ref": "SubmitProvisioningConfigResponse" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/provisioningConfigs:submit", "id": "baremetalsolution.projects.locations.provisioningConfigs.submit", "description": "Submit a provisioning configuration for a given project.", "httpMethod": "POST" }, "get": { "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/provisioningConfigs/{provisioningConfigsId}", "id": "baremetalsolution.projects.locations.provisioningConfigs.get", "description": "Get ProvisioningConfig by name.", "httpMethod": "GET", "path": "v2/{+name}", "parameters": { "name": { "type": "string", "description": "Required. Name of the ProvisioningConfig.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/provisioningConfigs/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ProvisioningConfig" } }, "patch": { "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/provisioningConfigs/{provisioningConfigsId}", "id": "baremetalsolution.projects.locations.provisioningConfigs.patch", "description": "Update existing ProvisioningConfig.", "httpMethod": "PATCH", "path": "v2/{+name}", "parameters": { "email": { "type": "string", "description": "Optional. Email provided to send a confirmation with provisioning config to.", "location": "query" }, "name": { "type": "string", "description": "Output only. The system-generated name of the provisioning config. This follows the UUID format.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/provisioningConfigs/[^/]+$", "location": "path" }, "updateMask": { "format": "google-fieldmask", "description": "Required. The list of fields to update.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "ProvisioningConfig" }, "response": { "$ref": "ProvisioningConfig" } }, "create": { "response": { "$ref": "ProvisioningConfig" }, "path": "v2/{+parent}/provisioningConfigs", "request": { "$ref": "ProvisioningConfig" }, "parameters": { "parent": { "type": "string", "description": "Required. The parent project and location containing the ProvisioningConfig.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" }, "email": { "type": "string", "description": "Optional. Email provided to send a confirmation with provisioning config to.", "location": "query" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Create new ProvisioningConfig.", "id": "baremetalsolution.projects.locations.provisioningConfigs.create", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/provisioningConfigs" } } }, "sshKeys": { "methods": { "list": { "response": { "$ref": "ListSSHKeysResponse" }, "parameters": { "pageSize": { "format": "int32", "type": "integer", "description": "The maximum number of items to return.", "location": "query" }, "pageToken": { "description": "The next_page_token value returned from a previous List request, if any.", "location": "query", "type": "string" }, "parent": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent containing the SSH keys. Currently, the only valid value for the location is \"global\".", "type": "string", "required": true } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/sshKeys", "httpMethod": "GET", "description": "Lists the public SSH keys registered for the specified project. These SSH keys are used only for the interactive serial console feature.", "id": "baremetalsolution.projects.locations.sshKeys.list", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/sshKeys" }, "create": { "response": { "$ref": "SSHKey" }, "path": "v2/{+parent}/sshKeys", "parameters": { "parent": { "type": "string", "description": "Required. The parent containing the SSH keys.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" }, "sshKeyId": { "type": "string", "description": "Required. The ID to use for the key, which will become the final component of the key's resource name. This value must match the regex: [a-zA-Z0-9@.\\-_]{1,64}", "location": "query" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "SSHKey" }, "description": "Register a public SSH key in the specified project for use with the interactive serial console feature.", "httpMethod": "POST", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/sshKeys", "id": "baremetalsolution.projects.locations.sshKeys.create" }, "delete": { "response": { "$ref": "Empty" }, "path": "v2/{+name}", "parameters": { "name": { "required": true, "description": "Required. The name of the SSH key to delete. Currently, the only valid value for the location is \"global\".", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/sshKeys/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a public SSH key registered in the specified project.", "httpMethod": "DELETE", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/sshKeys/{sshKeysId}", "id": "baremetalsolution.projects.locations.sshKeys.delete" } } }, "provisioningQuotas": { "methods": { "list": { "id": "baremetalsolution.projects.locations.provisioningQuotas.list", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/provisioningQuotas", "httpMethod": "GET", "description": "List the budget details to provision resources on a given project.", "parameters": { "pageSize": { "type": "integer", "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default. Notice that page_size field is not supported and won't be respected in the API request for now, will be updated when pagination is supported.", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "A token identifying a page of results from the server.", "location": "query" }, "parent": { "required": true, "type": "string", "description": "Required. Parent value for ListProvisioningQuotasRequest.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/provisioningQuotas", "response": { "$ref": "ListProvisioningQuotasResponse" } } } }, "operations": { "methods": { "get": { "path": "v2/{+name}", "parameters": { "name": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/operations/.*$", "required": true, "description": "The name of the operation resource.", "type": "string" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "id": "baremetalsolution.projects.locations.operations.get", "description": "Get details about an operation.", "httpMethod": "GET" } } }, "nfsShares": { "methods": { "get": { "description": "Get details of a single NFS share.", "httpMethod": "GET", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/nfsShares/{nfsSharesId}", "id": "baremetalsolution.projects.locations.nfsShares.get", "response": { "$ref": "NfsShare" }, "path": "v2/{+name}", "parameters": { "name": { "required": true, "type": "string", "description": "Required. Name of the resource.", "pattern": "^projects/[^/]+/locations/[^/]+/nfsShares/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "description": "Update details of a single NFS share.", "httpMethod": "PATCH", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/nfsShares/{nfsSharesId}", "id": "baremetalsolution.projects.locations.nfsShares.patch", "response": { "$ref": "Operation" }, "path": "v2/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/nfsShares/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Immutable. The name of the NFS share." }, "updateMask": { "format": "google-fieldmask", "description": "The list of fields to update. The only currently supported fields are: `labels` `allowed_clients`", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "NfsShare" } }, "rename": { "response": { "$ref": "NfsShare" }, "path": "v2/{+name}:rename", "request": { "$ref": "RenameNfsShareRequest" }, "parameters": { "name": { "required": true, "description": "Required. The `name` field is used to identify the nfsshare. Format: projects/{project}/locations/{location}/nfsshares/{nfsshare}", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/nfsShares/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "RenameNfsShare sets a new name for an nfsshare. Use with caution, previous names become immediately invalidated.", "id": "baremetalsolution.projects.locations.nfsShares.rename", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/nfsShares/{nfsSharesId}:rename" }, "delete": { "response": { "$ref": "Operation" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/nfsShares/[^/]+$", "location": "path", "type": "string", "description": "Required. The name of the NFS share to delete.", "required": true } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}", "httpMethod": "DELETE", "description": "Delete an NFS share. The underlying volume is automatically deleted.", "id": "baremetalsolution.projects.locations.nfsShares.delete", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/nfsShares/{nfsSharesId}" }, "list": { "response": { "$ref": "ListNfsSharesResponse" }, "path": "v2/{+parent}/nfsShares", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. Parent value for ListNfsSharesRequest." }, "pageSize": { "format": "int32", "type": "integer", "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query" }, "pageToken": { "description": "A token identifying a page of results from the server.", "location": "query", "type": "string" }, "filter": { "description": "List filter.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "List NFS shares.", "httpMethod": "GET", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/nfsShares", "id": "baremetalsolution.projects.locations.nfsShares.list" }, "create": { "response": { "$ref": "Operation" }, "request": { "$ref": "NfsShare" }, "parameters": { "parent": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent project and location.", "type": "string", "required": true } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/nfsShares", "httpMethod": "POST", "description": "Create an NFS share.", "id": "baremetalsolution.projects.locations.nfsShares.create", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/nfsShares" } } }, "networks": { "methods": { "patch": { "httpMethod": "PATCH", "description": "Update details of a single network.", "id": "baremetalsolution.projects.locations.networks.patch", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/networks/{networksId}", "response": { "$ref": "Operation" }, "path": "v2/{+name}", "request": { "$ref": "Network" }, "parameters": { "name": { "required": true, "description": "Output only. The resource name of this `Network`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. Format: `projects/{project}/locations/{location}/networks/{network}`", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/networks/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "The list of fields to update. The only currently supported fields are: `labels`, `reservations`, `vrf.vlan_attachments`", "location": "query" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "rename": { "path": "v2/{+name}:rename", "parameters": { "name": { "required": true, "type": "string", "description": "Required. The `name` field is used to identify the network. Format: projects/{project}/locations/{location}/networks/{network}", "pattern": "^projects/[^/]+/locations/[^/]+/networks/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "RenameNetworkRequest" }, "response": { "$ref": "Network" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/networks/{networksId}:rename", "id": "baremetalsolution.projects.locations.networks.rename", "description": "RenameNetwork sets a new name for a network. Use with caution, previous names become immediately invalidated.", "httpMethod": "POST" }, "listNetworkUsage": { "parameters": { "location": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "type": "string", "description": "Required. Parent value (project and location).", "required": true } }, "parameterOrder": [ "location" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+location}/networks:listNetworkUsage", "response": { "$ref": "ListNetworkUsageResponse" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/networks:listNetworkUsage", "id": "baremetalsolution.projects.locations.networks.listNetworkUsage", "description": "List all Networks (and used IPs for each Network) in the vendor account associated with the specified project.", "httpMethod": "GET" }, "get": { "parameters": { "name": { "type": "string", "description": "Required. Name of the resource.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/networks/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+name}", "response": { "$ref": "Network" }, "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/networks/{networksId}", "id": "baremetalsolution.projects.locations.networks.get", "description": "Get details of a single network.", "httpMethod": "GET" }, "list": { "httpMethod": "GET", "description": "List network in a given project and location.", "id": "baremetalsolution.projects.locations.networks.list", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/networks", "response": { "$ref": "ListNetworksResponse" }, "parameters": { "parent": { "required": true, "description": "Required. Parent value for ListNetworksRequest.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "filter": { "type": "string", "description": "List filter.", "location": "query" }, "pageSize": { "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "description": "A token identifying a page of results from the server.", "location": "query" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v2/{+parent}/networks" } } } } } } } }, "parameters": { "quotaUser": { "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.", "location": "query", "type": "string" }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query", "type": "string" }, "prettyPrint": { "description": "Returns response with indentations and line breaks.", "location": "query", "type": "boolean", "default": "true" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "location": "query", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ], "description": "Data format for response.", "type": "string", "default": "json" }, "$.xgafv": { "description": "V1 error format.", "type": "string", "location": "query", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ] }, "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" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "callback": { "type": "string", "description": "JSONP", "location": "query" } }, "version_module": true, "documentationLink": "https://cloud.google.com/bare-metal", "version": "v2", "ownerDomain": "google.com" }