{ "baseUrl": "https://vmwareengine.googleapis.com/", "id": "vmwareengine:v1", "discoveryVersion": "v1", "version": "v1", "title": "VMware Engine API", "canonicalName": "VMware Engine", "batchPath": "batch", "ownerDomain": "google.com", "version_module": true, "name": "vmwareengine", "resources": { "projects": { "resources": { "locations": { "resources": { "datastores": { "methods": { "list": { "parameters": { "pageToken": { "description": "Optional. A page token, received from a previous `ListDatastores` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDatastores` must match the call that provided the page token.", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "description": "Optional. The maximum number of results to return in one page. The maximum value is coerced to 1000. The default value of this field is 500.", "type": "integer", "location": "query" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the location to query for Datastores. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1`" }, "requestId": { "location": "query", "type": "string", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "orderBy": { "type": "string", "location": "query", "description": "Optional. Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported." }, "filter": { "location": "query", "description": "Optional. A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of datastores, you can exclude the ones named `example-datastore` by specifying `name != \"example-datastore\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-datastore\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-datastore-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-datastore-2\") ```", "type": "string" } }, "response": { "$ref": "ListDatastoresResponse" }, "id": "vmwareengine.projects.locations.datastores.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datastores", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists `Datastore` resources in a given project and location.", "path": "v1/{+parent}/datastores", "httpMethod": "GET", "parameterOrder": [ "parent" ] }, "patch": { "id": "vmwareengine.projects.locations.datastores.patch", "description": "Modifies a Datastore resource. Only fields specified in `updateMask` are applied.", "httpMethod": "PATCH", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datastores/{datastoresId}", "parameterOrder": [ "name" ], "request": { "$ref": "Datastore" }, "response": { "$ref": "Operation" }, "path": "v1/{+name}", "parameters": { "requestId": { "type": "string", "location": "query", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "updateMask": { "format": "google-fieldmask", "type": "string", "location": "query", "description": "Optional. Field mask is used to specify the fields to be overwritten in the Datastore resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten." }, "name": { "description": "Output only. Identifier. The resource name of this datastore. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/datastores/datastore`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datastores/[^/]+$", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "path": "v1/{+parent}/datastores", "parameterOrder": [ "parent" ], "request": { "$ref": "Datastore" }, "id": "vmwareengine.projects.locations.datastores.create", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the location to create the new datastore in. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "datastoreId": { "location": "query", "description": "Required. The user-provided identifier of the datastore to be created. This identifier must be unique among each `Datastore` within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)", "type": "string" }, "requestId": { "type": "string", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datastores", "description": "Creates a new `Datastore` resource in a given project and location.", "response": { "$ref": "Operation" } }, "delete": { "httpMethod": "DELETE", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a `Datastore` resource. You can only delete a Datastore after all resources that refer to it are deleted. For example, multiple clusters of the same private cloud or different private clouds can refer to the same datastore.", "path": "v1/{+name}", "response": { "$ref": "Operation" }, "id": "vmwareengine.projects.locations.datastores.delete", "parameters": { "requestId": { "type": "string", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query" }, "name": { "description": "Required. The resource name of the Datastore to be deleted. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/datastore/my-datastore`", "pattern": "^projects/[^/]+/locations/[^/]+/datastores/[^/]+$", "type": "string", "location": "path", "required": true }, "etag": { "location": "query", "description": "Optional. Checksum used to ensure that the user-provided value is up to date before the server processes the request. The server compares provided checksum with the current checksum of the resource. If the user-provided value is out of date, this request returns an `ABORTED` error.", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datastores/{datastoresId}" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Datastore" }, "parameterOrder": [ "name" ], "id": "vmwareengine.projects.locations.datastores.get", "parameters": { "name": { "description": "Required. The resource name of the Datastore to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/datastores/my-datastore`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datastores/[^/]+$" } }, "description": "Retrieves a `Datastore` resource by its resource name. The resource contains details of the Datastore, such as its description, subnets, type, and more.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/datastores/{datastoresId}", "httpMethod": "GET", "path": "v1/{+name}" } } }, "privateClouds": { "methods": { "resetNsxCredentials": { "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "privateCloud" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:resetNsxCredentials", "httpMethod": "POST", "parameters": { "privateCloud": { "description": "Required. The resource name of the private cloud to reset credentials for. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$" } }, "request": { "$ref": "ResetNsxCredentialsRequest" }, "description": "Resets credentials of the NSX appliance.", "id": "vmwareengine.projects.locations.privateClouds.resetNsxCredentials", "path": "v1/{+privateCloud}:resetNsxCredentials" }, "showNsxCredentials": { "parameterOrder": [ "privateCloud" ], "description": "Gets details of credentials for NSX appliance.", "response": { "$ref": "Credentials" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+privateCloud}:showNsxCredentials", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:showNsxCredentials", "id": "vmwareengine.projects.locations.privateClouds.showNsxCredentials", "parameters": { "privateCloud": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the private cloud to be queried for credentials. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$" } } }, "testIamPermissions": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:testIamPermissions", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string" } }, "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "response": { "$ref": "TestIamPermissionsResponse" }, "request": { "$ref": "TestIamPermissionsRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+resource}:testIamPermissions", "id": "vmwareengine.projects.locations.privateClouds.testIamPermissions", "parameterOrder": [ "resource" ], "httpMethod": "POST" }, "delete": { "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "force": { "location": "query", "description": "Optional. If set to true, cascade delete is enabled and all children of this private cloud resource are also deleted. When this flag is set to false, the private cloud will not be deleted if there are any children other than the management cluster. The management cluster is always deleted.", "type": "boolean" }, "delayHours": { "location": "query", "format": "int32", "description": "Optional. Time delay of the deletion specified in hours. The default value is `3`. Specifying a non-zero value for this field changes the value of `PrivateCloud.state` to `DELETED` and sets `expire_time` to the planned deletion time. Deletion can be cancelled before `expire_time` elapses using VmwareEngine.UndeletePrivateCloud. Specifying a value of `0` for this field instead begins the deletion process and ceases billing immediately. During the final deletion process, the value of `PrivateCloud.state` becomes `PURGING`.", "type": "integer" }, "name": { "description": "Required. The resource name of the private cloud to delete. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true, "type": "string" }, "requestId": { "location": "query", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "path": "v1/{+name}", "description": "Schedules a `PrivateCloud` resource for deletion. A `PrivateCloud` resource scheduled for deletion has `PrivateCloud.state` set to `DELETED` and `expireTime` set to the time when deletion is final and can no longer be reversed. The delete operation is marked as done as soon as the `PrivateCloud` is successfully scheduled for deletion (this also applies when `delayHours` is set to zero), and the operation is not kept in pending state until `PrivateCloud` is purged. `PrivateCloud` can be restored using `UndeletePrivateCloud` method before the `expireTime` elapses. When `expireTime` is reached, deletion is final and all private cloud resources are irreversibly removed and billing stops. During the final removal process, `PrivateCloud.state` is set to `PURGING`. `PrivateCloud` can be polled using standard `GET` method for the whole period of deletion and purging. It will not be returned only when it is completely purged.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}", "id": "vmwareengine.projects.locations.privateClouds.delete" }, "getDnsForwarding": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "DnsForwarding" }, "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/dnsForwarding", "description": "Gets details of the `DnsForwarding` config.", "id": "vmwareengine.projects.locations.privateClouds.getDnsForwarding", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/dnsForwarding$", "description": "Required. The resource name of a `DnsForwarding` to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/dnsForwarding`", "location": "path", "required": true } } }, "get": { "id": "vmwareengine.projects.locations.privateClouds.get", "response": { "$ref": "PrivateCloud" }, "httpMethod": "GET", "parameterOrder": [ "name" ], "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "type": "string", "description": "Required. The resource name of the private cloud to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieves a `PrivateCloud` resource by its resource name." }, "showVcenterCredentials": { "id": "vmwareengine.projects.locations.privateClouds.showVcenterCredentials", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "privateCloud" ], "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:showVcenterCredentials", "path": "v1/{+privateCloud}:showVcenterCredentials", "parameters": { "username": { "location": "query", "description": "Optional. The username of the user to be queried for credentials. The default value of this field is CloudOwner@gve.local. The provided value must be one of the following: CloudOwner@gve.local, solution-user-01@gve.local, solution-user-02@gve.local, solution-user-03@gve.local, solution-user-04@gve.local, solution-user-05@gve.local, zertoadmin@gve.local.", "type": "string" }, "privateCloud": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the private cloud to be queried for credentials. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`" } }, "response": { "$ref": "Credentials" }, "description": "Gets details of credentials for Vcenter appliance." }, "resetVcenterCredentials": { "parameterOrder": [ "privateCloud" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateClouds.resetVcenterCredentials", "path": "v1/{+privateCloud}:resetVcenterCredentials", "response": { "$ref": "Operation" }, "parameters": { "privateCloud": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "description": "Required. The resource name of the private cloud to reset credentials for. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "location": "path", "required": true, "type": "string" } }, "request": { "$ref": "ResetVcenterCredentialsRequest" }, "description": "Resets credentials of the Vcenter appliance.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:resetVcenterCredentials" }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "parameters": { "resource": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Policy" }, "httpMethod": "POST", "parameterOrder": [ "resource" ], "path": "v1/{+resource}:setIamPolicy", "request": { "$ref": "SetIamPolicyRequest" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:setIamPolicy", "id": "vmwareengine.projects.locations.privateClouds.setIamPolicy" }, "list": { "path": "v1/{+parent}/privateClouds", "parameters": { "filter": { "location": "query", "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of private clouds, you can exclude the ones named `example-pc` by specifying `name != \"example-pc\"`. You can also filter nested fields. For example, you could specify `networkConfig.managementCidr = \"192.168.0.0/24\"` to include private clouds only if they have a matching address in their network configuration. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-pc\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"private-cloud-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"private-cloud-2\") ```", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the private cloud to be queried for clusters. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a`", "location": "path", "required": true }, "orderBy": { "location": "query", "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "type": "string" }, "pageToken": { "type": "string", "description": "A page token, received from a previous `ListPrivateClouds` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPrivateClouds` must match the call that provided the page token.", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "description": "The maximum number of private clouds to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "format": "int32" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds", "response": { "$ref": "ListPrivateCloudsResponse" }, "id": "vmwareengine.projects.locations.privateClouds.list", "description": "Lists `PrivateCloud` resources in a given project and location.", "parameterOrder": [ "parent" ], "httpMethod": "GET" }, "undelete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the private cloud scheduled for deletion. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Restores a private cloud that was previously scheduled for deletion by `DeletePrivateCloud`. A `PrivateCloud` resource scheduled for deletion has `PrivateCloud.state` set to `DELETED` and `PrivateCloud.expireTime` set to the time when deletion can no longer be reversed.", "id": "vmwareengine.projects.locations.privateClouds.undelete", "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:undelete", "path": "v1/{+name}:undelete", "request": { "$ref": "UndeletePrivateCloudRequest" }, "httpMethod": "POST", "response": { "$ref": "Operation" } }, "getIamPolicy": { "id": "vmwareengine.projects.locations.privateClouds.getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1/{+resource}:getIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "parameters": { "options.requestedPolicyVersion": { "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "type": "integer", "location": "query", "format": "int32" }, "resource": { "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set." }, "migrateManagementVms": { "request": { "$ref": "MigrateManagementVmsRequest" }, "description": "Migrates the management VMs of the PC from the current management cluster to a workload cluster. Post this migration, the provided workload cluster becomes the management cluster", "path": "v1/{+name}:migrateManagementVms", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the private cloud whose management vms are getting migrated. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "vmwareengine.projects.locations.privateClouds.migrateManagementVms", "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:migrateManagementVms" }, "patch": { "parameters": { "requestId": { "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "name": { "description": "Output only. Identifier. The resource name of this private cloud. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$" }, "updateMask": { "location": "query", "type": "string", "format": "google-fieldmask", "description": "Required. Field mask is used to specify the fields to be overwritten in the `PrivateCloud` resource by the update. The fields specified in `updateMask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten." }, "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query" } }, "path": "v1/{+name}", "description": "Modifies a `PrivateCloud` resource. Only the following fields can be updated: `description`. Only fields specified in `updateMask` are applied. During operation processing, the resource is temporarily in the `ACTIVE` state before the operation fully completes. For that period of time, you can't update the resource. Use the operation status to determine when the processing fully completes.", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "request": { "$ref": "PrivateCloud" }, "id": "vmwareengine.projects.locations.privateClouds.patch", "httpMethod": "PATCH", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "updateDnsForwarding": { "request": { "$ref": "DnsForwarding" }, "parameterOrder": [ "name" ], "httpMethod": "PATCH", "id": "vmwareengine.projects.locations.privateClouds.updateDnsForwarding", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/dnsForwarding", "description": "Updates the parameters of the `DnsForwarding` config, like associated domains. Only fields specified in `update_mask` are applied.", "parameters": { "requestId": { "location": "query", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/dnsForwarding$", "type": "string", "description": "Output only. Identifier. The resource name of this DNS profile. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/dnsForwarding`", "location": "path", "required": true }, "updateMask": { "format": "google-fieldmask", "description": "Required. Field mask is used to specify the fields to be overwritten in the `DnsForwarding` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "type": "string", "location": "query" } }, "response": { "$ref": "Operation" } }, "create": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds", "id": "vmwareengine.projects.locations.privateClouds.create", "request": { "$ref": "PrivateCloud" }, "httpMethod": "POST", "response": { "$ref": "Operation" }, "description": "Creates a new `PrivateCloud` resource in a given project and location. Private clouds of type `STANDARD` and `TIME_LIMITED` are zonal resources, `STRETCHED` private clouds are regional. Creating a private cloud also creates a [management cluster](https://cloud.google.com/vmware-engine/docs/concepts-vmware-components) for that private cloud.", "parameterOrder": [ "parent" ], "parameters": { "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query" }, "privateCloudId": { "location": "query", "description": "Required. The user-provided identifier of the private cloud to be created. This identifier must be unique among each `PrivateCloud` within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)", "type": "string" }, "requestId": { "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string", "location": "query" }, "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the location to create the new private cloud in. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a`", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "path": "v1/{+parent}/privateClouds", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "privateCloudDeletionNow": { "id": "vmwareengine.projects.locations.privateClouds.privateCloudDeletionNow", "parameters": { "name": { "description": "Required. The resource name of the private cloud in softdeletion. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true } }, "path": "v1/{+name}:privateCloudDeletionNow", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "POST", "response": { "$ref": "Operation" }, "request": { "$ref": "AcceleratePrivateCloudDeletionRequest" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}:privateCloudDeletionNow", "description": "Accelerates the deletion of a private cloud that is currently in soft deletion A `PrivateCloud` resource in soft deletion has `PrivateCloud.state` set to `SOFT_DELETED` and `PrivateCloud.expireTime` set to the time when deletion can no longer be reversed." } }, "resources": { "externalAddresses": { "methods": { "patch": { "path": "v1/{+name}", "parameters": { "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "name": { "description": "Output only. Identifier. The resource name of this external IP address. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/externalAddresses/[^/]+$", "location": "path", "required": true, "type": "string" }, "updateMask": { "format": "google-fieldmask", "location": "query", "type": "string", "description": "Required. Field mask is used to specify the fields to be overwritten in the `ExternalAddress` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten." }, "validateOnly": { "location": "query", "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request." } }, "request": { "$ref": "ExternalAddress" }, "description": "Updates the parameters of a single external IP address. Only fields specified in `update_mask` are applied. During operation processing, the resource is temporarily in the `ACTIVE` state before the operation fully completes. For that period of time, you can't update the resource. Use the operation status to determine when the processing fully completes.", "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/externalAddresses/{externalAddressesId}", "parameterOrder": [ "name" ], "id": "vmwareengine.projects.locations.privateClouds.externalAddresses.patch", "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "path": "v1/{+parent}/externalAddresses", "description": "Creates a new `ExternalAddress` resource in a given private cloud. The network policy that corresponds to the private cloud must have the external IP address network service enabled (`NetworkPolicy.external_ip`).", "httpMethod": "POST", "parameters": { "requestId": { "location": "query", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "description": "Required. The resource name of the private cloud to create a new external IP address in. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "type": "string" }, "validateOnly": { "type": "boolean", "location": "query", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request." }, "externalAddressId": { "type": "string", "description": "Required. The user-provided identifier of the `ExternalAddress` to be created. This identifier must be unique among `ExternalAddress` resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)", "location": "query" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/externalAddresses", "request": { "$ref": "ExternalAddress" }, "id": "vmwareengine.projects.locations.privateClouds.externalAddresses.create", "response": { "$ref": "Operation" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "path": "v1/{+name}", "id": "vmwareengine.projects.locations.privateClouds.externalAddresses.delete", "description": "Deletes a single external IP address. When you delete an external IP address, connectivity between the external IP address and the corresponding internal IP address is lost.", "parameters": { "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/externalAddresses/[^/]+$", "type": "string", "description": "Required. The resource name of the external IP address to delete. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-ip`" } }, "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/externalAddresses/{externalAddressesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "DELETE" }, "get": { "id": "vmwareengine.projects.locations.privateClouds.externalAddresses.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/externalAddresses/{externalAddressesId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/externalAddresses/[^/]+$", "description": "Required. The resource name of the external IP address to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-ip`", "type": "string" } }, "response": { "$ref": "ExternalAddress" }, "description": "Gets details of a single external IP address.", "httpMethod": "GET", "path": "v1/{+name}" }, "list": { "httpMethod": "GET", "path": "v1/{+parent}/externalAddresses", "response": { "$ref": "ListExternalAddressesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateClouds.externalAddresses.list", "parameters": { "orderBy": { "type": "string", "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "location": "query" }, "filter": { "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of IP addresses, you can exclude the ones named `example-ip` by specifying `name != \"example-ip\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-ip\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-ip-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-ip-2\") ```", "type": "string", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "type": "string", "description": "Required. The resource name of the private cloud to be queried for external IP addresses. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "location": "path", "required": true }, "pageToken": { "location": "query", "description": "A page token, received from a previous `ListExternalAddresses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListExternalAddresses` must match the call that provided the page token.", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "The maximum number of external IP addresses to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "type": "integer" } }, "parameterOrder": [ "parent" ], "description": "Lists external IP addresses assigned to VMware workload VMs in a given private cloud.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/externalAddresses" } } }, "hcxActivationKeys": { "methods": { "testIamPermissions": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "parameters": { "resource": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/hcxActivationKeys/[^/]+$", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "path": "v1/{+resource}:testIamPermissions", "id": "vmwareengine.projects.locations.privateClouds.hcxActivationKeys.testIamPermissions", "request": { "$ref": "TestIamPermissionsRequest" }, "response": { "$ref": "TestIamPermissionsResponse" }, "httpMethod": "POST", "parameterOrder": [ "resource" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/hcxActivationKeys/{hcxActivationKeysId}:testIamPermissions" }, "setIamPolicy": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "httpMethod": "POST", "request": { "$ref": "SetIamPolicyRequest" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/hcxActivationKeys/{hcxActivationKeysId}:setIamPolicy", "path": "v1/{+resource}:setIamPolicy", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/hcxActivationKeys/[^/]+$", "location": "path", "required": true, "type": "string", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "id": "vmwareengine.projects.locations.privateClouds.hcxActivationKeys.setIamPolicy" }, "get": { "id": "vmwareengine.projects.locations.privateClouds.hcxActivationKeys.get", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/hcxActivationKeys/[^/]+$", "type": "string", "description": "Required. The resource name of the HCX activation key to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateClouds/my-cloud/hcxActivationKeys/my-key`" } }, "parameterOrder": [ "name" ], "response": { "$ref": "HcxActivationKey" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/hcxActivationKeys/{hcxActivationKeysId}", "path": "v1/{+name}", "description": "Retrieves a `HcxActivationKey` resource by its resource name." }, "create": { "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/hcxActivationKeys", "httpMethod": "POST", "parameters": { "hcxActivationKeyId": { "location": "query", "type": "string", "description": "Required. The user-provided identifier of the `HcxActivationKey` to be created. This identifier must be unique among `HcxActivationKey` resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "description": "Required. The resource name of the private cloud to create the key for. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateClouds/my-cloud`", "type": "string" }, "requestId": { "location": "query", "type": "string", "description": "A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "path": "v1/{+parent}/hcxActivationKeys", "id": "vmwareengine.projects.locations.privateClouds.hcxActivationKeys.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new HCX activation key in a given private cloud.", "parameterOrder": [ "parent" ], "request": { "$ref": "HcxActivationKey" } }, "getIamPolicy": { "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/hcxActivationKeys/[^/]+$", "location": "path", "required": true, "type": "string" }, "options.requestedPolicyVersion": { "type": "integer", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query", "format": "int32" } }, "id": "vmwareengine.projects.locations.privateClouds.hcxActivationKeys.getIamPolicy", "parameterOrder": [ "resource" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/hcxActivationKeys/{hcxActivationKeysId}:getIamPolicy", "response": { "$ref": "Policy" }, "path": "v1/{+resource}:getIamPolicy", "httpMethod": "GET" }, "list": { "response": { "$ref": "ListHcxActivationKeysResponse" }, "id": "vmwareengine.projects.locations.privateClouds.hcxActivationKeys.list", "parameters": { "pageToken": { "description": "A page token, received from a previous `ListHcxActivationKeys` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListHcxActivationKeys` must match the call that provided the page token.", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "description": "The maximum number of HCX activation keys to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "location": "query" }, "parent": { "type": "string", "description": "Required. The resource name of the private cloud to be queried for HCX activation keys. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateClouds/my-cloud`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true } }, "description": "Lists `HcxActivationKey` resources in a given private cloud.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/hcxActivationKeys", "parameterOrder": [ "parent" ], "httpMethod": "GET", "path": "v1/{+parent}/hcxActivationKeys", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "clusters": { "methods": { "mountDatastore": { "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "Required. The resource name of the cluster to mount the datastore. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "location": "path", "required": true } }, "description": "Mounts a `Datastore` on a cluster resource", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateClouds.clusters.mountDatastore", "request": { "$ref": "MountDatastoreRequest" }, "response": { "$ref": "Operation" }, "path": "v1/{+name}:mountDatastore", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}:mountDatastore", "httpMethod": "POST" }, "create": { "request": { "$ref": "Cluster" }, "path": "v1/{+parent}/clusters", "httpMethod": "POST", "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters", "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "validateOnly": { "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query", "type": "boolean" }, "clusterId": { "type": "string", "description": "Required. The user-provided identifier of the new `Cluster`. This identifier must be unique among clusters within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the private cloud to create a new cluster in. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$" }, "requestId": { "type": "string", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query" } }, "id": "vmwareengine.projects.locations.privateClouds.clusters.create", "description": "Creates a new cluster in a given private cloud. Creating a new cluster provides additional nodes for use in the parent private cloud and requires sufficient [node quota](https://cloud.google.com/vmware-engine/quotas)." }, "unmountDatastore": { "httpMethod": "POST", "request": { "$ref": "UnmountDatastoreRequest" }, "path": "v1/{+name}:unmountDatastore", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}:unmountDatastore", "id": "vmwareengine.projects.locations.privateClouds.clusters.unmountDatastore", "description": "Unmounts a `Datastore` on a cluster resource", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "description": "Required. The resource name of the cluster to unmount the datastore. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster`" } } }, "get": { "parameterOrder": [ "name" ], "id": "vmwareengine.projects.locations.privateClouds.clusters.get", "description": "Retrieves a `Cluster` resource by its resource name.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "Required. The cluster resource name to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}", "response": { "$ref": "Cluster" }, "path": "v1/{+name}" }, "testIamPermissions": { "path": "v1/{+resource}:testIamPermissions", "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "location": "path", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}:testIamPermissions", "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "httpMethod": "POST", "id": "vmwareengine.projects.locations.privateClouds.clusters.testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "TestIamPermissionsResponse" } }, "patch": { "id": "vmwareengine.projects.locations.privateClouds.clusters.patch", "response": { "$ref": "Operation" }, "parameters": { "requestId": { "type": "string", "location": "query", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "description": "Output only. Identifier. The resource name of this cluster. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster`", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten in the `Cluster` resource by the update. The fields specified in the `updateMask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "request": { "$ref": "Cluster" }, "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}", "parameterOrder": [ "name" ], "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Modifies a `Cluster` resource. Only fields specified in `updateMask` are applied. During operation processing, the resource is temporarily in the `ACTIVE` state before the operation fully completes. For that period of time, you can't update the resource. Use the operation status to determine when the processing fully completes." }, "delete": { "httpMethod": "DELETE", "description": "Deletes a `Cluster` resource. To avoid unintended data loss, migrate or gracefully shut down any workloads running on the cluster before deletion. You cannot delete the management cluster of a private cloud using this method.", "path": "v1/{+name}", "response": { "$ref": "Operation" }, "id": "vmwareengine.projects.locations.privateClouds.clusters.delete", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "type": "string", "description": "Required. The resource name of the cluster to delete. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster`", "location": "path", "required": true }, "requestId": { "type": "string", "location": "query", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}", "parameterOrder": [ "name" ] }, "list": { "path": "v1/{+parent}/clusters", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "description": "Required. The resource name of the private cloud to query for clusters. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "type": "string" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The maximum number of clusters to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500." }, "filter": { "type": "string", "description": " To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-cluster\") (nodeCount = \"3\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-cluster-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-cluster-2\") ```", "location": "query" }, "orderBy": { "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "location": "query", "type": "string" }, "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous `ListClusters` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListClusters` must match the call that provided the page token." } }, "parameterOrder": [ "parent" ], "id": "vmwareengine.projects.locations.privateClouds.clusters.list", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters", "httpMethod": "GET", "description": "Lists `Cluster` resources in a given private cloud.", "response": { "$ref": "ListClustersResponse" } }, "getIamPolicy": { "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "parameterOrder": [ "resource" ], "parameters": { "resource": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string" }, "options.requestedPolicyVersion": { "format": "int32", "type": "integer", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query" } }, "path": "v1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Policy" }, "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}:getIamPolicy", "id": "vmwareengine.projects.locations.privateClouds.clusters.getIamPolicy" }, "setIamPolicy": { "path": "v1/{+resource}:setIamPolicy", "httpMethod": "POST", "id": "vmwareengine.projects.locations.privateClouds.clusters.setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "type": "string", "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "response": { "$ref": "Policy" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "request": { "$ref": "SetIamPolicyRequest" }, "parameterOrder": [ "resource" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}:setIamPolicy" } }, "resources": { "nodes": { "methods": { "get": { "id": "vmwareengine.projects.locations.privateClouds.clusters.nodes.get", "description": "Gets details of a single node.", "httpMethod": "GET", "response": { "$ref": "Node" }, "path": "v1/{+name}", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the node to retrieve. For example: `projects/{project}/locations/{location}/privateClouds/{private_cloud}/clusters/{cluster}/nodes/{node}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+/nodes/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}/nodes/{nodesId}" }, "list": { "response": { "$ref": "ListNodesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists nodes in a given cluster.", "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/clusters/{clustersId}/nodes", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/clusters/[^/]+$", "description": "Required. The resource name of the cluster to be queried for nodes. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster`", "type": "string", "location": "path", "required": true }, "pageToken": { "description": "A page token, received from a previous `ListNodes` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListNodes` must match the call that provided the page token.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "description": "The maximum number of nodes to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "format": "int32" } }, "id": "vmwareengine.projects.locations.privateClouds.clusters.nodes.list", "path": "v1/{+parent}/nodes" } } } } }, "upgrades": { "methods": { "list": { "httpMethod": "GET", "id": "vmwareengine.projects.locations.privateClouds.upgrades.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "response": { "$ref": "ListUpgradesResponse" }, "description": "Lists past, ongoing and upcoming `Upgrades` for the given private cloud.", "parameters": { "orderBy": { "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "location": "query", "description": "The maximum number of `Upgrades` to return in one page. The service may return fewer resources than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of upgrades, you can exclude the ones named `example-upgrade1` by specifying `name != \"example-upgrade1\"`. You can also filter nested fields. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-upgrade\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"upgrade-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"upgrade-2\") ```" }, "pageToken": { "type": "string", "description": "A page token, received from a previous `ListUpgrades` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUpgrades` must match the call that provided the page token.", "location": "query" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "type": "string", "description": "Required. Query a list of `Upgrades` for the given private cloud resource name. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1-a/privateClouds/my-cloud`" } }, "path": "v1/{+parent}/upgrades", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/upgrades" }, "get": { "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the `Upgrade` resource to be retrieved. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/upgrades/[^/]+$" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/upgrades/{upgradesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateClouds.upgrades.get", "response": { "$ref": "Upgrade" }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "description": "Retrieves a private cloud `Upgrade` resource by its resource name.", "httpMethod": "GET" }, "patch": { "parameters": { "name": { "location": "path", "required": true, "description": "Output only. Identifier. The resource name of the private cloud `Upgrade`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/upgrades/[^/]+$", "type": "string" }, "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten in the `Upgrade` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "type": "string", "location": "query", "format": "google-fieldmask" }, "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" } }, "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/upgrades/{upgradesId}", "path": "v1/{+name}", "id": "vmwareengine.projects.locations.privateClouds.upgrades.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "request": { "$ref": "Upgrade" }, "description": "Update the private cloud `Upgrade` resource. Only `schedule` field can updated. The schedule can only be updated when the upgrade has not started and schedule edit window is open. Only fields specified in `update_mask` are considered.", "httpMethod": "PATCH" } } }, "subnets": { "methods": { "get": { "parameterOrder": [ "name" ], "response": { "$ref": "Subnet" }, "httpMethod": "GET", "description": "Gets details of a single subnet.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/subnets/{subnetsId}", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateClouds.subnets.get", "parameters": { "name": { "description": "Required. The resource name of the subnet to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/subnets/my-subnet`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/subnets/[^/]+$", "location": "path", "required": true, "type": "string" } } }, "patch": { "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/subnets/[^/]+$", "location": "path", "required": true, "description": "Output only. Identifier. The resource name of this subnet. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/subnets/my-subnet`" }, "updateMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Required. Field mask is used to specify the fields to be overwritten in the `Subnet` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten." } }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/subnets/{subnetsId}", "path": "v1/{+name}", "id": "vmwareengine.projects.locations.privateClouds.subnets.patch", "parameterOrder": [ "name" ], "request": { "$ref": "Subnet" }, "description": "Updates the parameters of a single subnet. Only fields specified in `update_mask` are applied. *Note*: This API is synchronous and always returns a successful `google.longrunning.Operation` (LRO). The returned LRO will only have `done` and `response` fields.", "httpMethod": "PATCH" }, "list": { "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/subnets", "description": "Lists subnets in a given private cloud.", "response": { "$ref": "ListSubnetsResponse" }, "parameters": { "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous `ListSubnetsRequest` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubnetsRequest` must match the call that provided the page token." }, "pageSize": { "description": "The maximum number of subnets to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "format": "int32", "type": "integer", "location": "query" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "description": "Required. The resource name of the private cloud to be queried for subnets. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "location": "path", "required": true } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateClouds.subnets.list", "path": "v1/{+parent}/subnets" } } }, "loggingServers": { "methods": { "list": { "path": "v1/{+parent}/loggingServers", "parameters": { "orderBy": { "location": "query", "type": "string", "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported." }, "pageToken": { "type": "string", "description": "A page token, received from a previous `ListLoggingServersRequest` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListLoggingServersRequest` must match the call that provided the page token.", "location": "query" }, "filter": { "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of logging servers, you can exclude the ones named `example-server` by specifying `name != \"example-server\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-server\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-server-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-server-2\") ```", "location": "query", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "type": "string", "description": "Required. The resource name of the private cloud to be queried for logging servers. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "location": "path", "required": true }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The maximum number of logging servers to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500." } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateClouds.loggingServers.list", "response": { "$ref": "ListLoggingServersResponse" }, "httpMethod": "GET", "description": "Lists logging servers configured for a given private cloud.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/loggingServers" }, "patch": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/loggingServers/{loggingServersId}", "path": "v1/{+name}", "httpMethod": "PATCH", "id": "vmwareengine.projects.locations.privateClouds.loggingServers.patch", "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "description": "Updates the parameters of a single logging server. Only fields specified in `update_mask` are applied.", "parameters": { "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string", "location": "query" }, "name": { "description": "Output only. The resource name of this logging server. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/loggingServers/my-logging-server`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/loggingServers/[^/]+$", "location": "path", "required": true }, "updateMask": { "location": "query", "description": "Required. Field mask is used to specify the fields to be overwritten in the `LoggingServer` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "format": "google-fieldmask", "type": "string" } }, "request": { "$ref": "LoggingServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "httpMethod": "GET", "response": { "$ref": "LoggingServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a logging server.", "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/loggingServers/{loggingServersId}", "id": "vmwareengine.projects.locations.privateClouds.loggingServers.get", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/loggingServers/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Logging Server to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/loggingServers/my-logging-server`" } }, "path": "v1/{+name}" }, "create": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/loggingServers", "parameterOrder": [ "parent" ], "id": "vmwareengine.projects.locations.privateClouds.loggingServers.create", "response": { "$ref": "Operation" }, "parameters": { "requestId": { "type": "string", "location": "query", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the private cloud to create a new Logging Server in. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`" }, "loggingServerId": { "type": "string", "location": "query", "description": "Required. The user-provided identifier of the `LoggingServer` to be created. This identifier must be unique among `LoggingServer` resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)" } }, "description": "Create a new logging server for a given private cloud.", "httpMethod": "POST", "request": { "$ref": "LoggingServer" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/loggingServers" }, "delete": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/loggingServers/{loggingServersId}", "parameters": { "requestId": { "location": "query", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/loggingServers/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the logging server to delete. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/loggingServers/my-logging-server`" } }, "response": { "$ref": "Operation" }, "id": "vmwareengine.projects.locations.privateClouds.loggingServers.delete", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "description": "Deletes a single logging server.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" } } }, "managementDnsZoneBindings": { "methods": { "create": { "path": "v1/{+parent}/managementDnsZoneBindings", "parameters": { "requestId": { "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query" }, "managementDnsZoneBindingId": { "type": "string", "location": "query", "description": "Required. The user-provided identifier of the `ManagementDnsZoneBinding` resource to be created. This identifier must be unique among `ManagementDnsZoneBinding` resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)" }, "parent": { "type": "string", "description": "Required. The resource name of the private cloud to create a new management DNS zone binding for. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/managementDnsZoneBindings", "description": "Creates a new `ManagementDnsZoneBinding` resource in a private cloud. This RPC creates the DNS binding and the resource that represents the DNS binding of the consumer VPC network to the management DNS zone. A management DNS zone is the Cloud DNS cross-project binding zone that VMware Engine creates for each private cloud. It contains FQDNs and corresponding IP addresses for the private cloud's ESXi hosts and management VM appliances like vCenter and NSX Manager.", "response": { "$ref": "Operation" }, "parameterOrder": [ "parent" ], "id": "vmwareengine.projects.locations.privateClouds.managementDnsZoneBindings.create", "request": { "$ref": "ManagementDnsZoneBinding" }, "httpMethod": "POST" }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a `ManagementDnsZoneBinding` resource. When a management DNS zone binding is deleted, the corresponding consumer VPC network is no longer bound to the management DNS zone.", "id": "vmwareengine.projects.locations.privateClouds.managementDnsZoneBindings.delete", "path": "v1/{+name}", "response": { "$ref": "Operation" }, "parameters": { "name": { "description": "Required. The resource name of the management DNS zone binding to delete. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-management-dns-zone-binding`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/managementDnsZoneBindings/[^/]+$", "type": "string", "location": "path", "required": true }, "requestId": { "location": "query", "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/managementDnsZoneBindings/{managementDnsZoneBindingsId}" }, "get": { "httpMethod": "GET", "description": "Retrieves a 'ManagementDnsZoneBinding' resource by its resource name.", "parameters": { "name": { "description": "Required. The resource name of the management DNS zone binding to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-management-dns-zone-binding`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/managementDnsZoneBindings/[^/]+$", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ManagementDnsZoneBinding" }, "id": "vmwareengine.projects.locations.privateClouds.managementDnsZoneBindings.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/managementDnsZoneBindings/{managementDnsZoneBindingsId}", "path": "v1/{+name}", "parameterOrder": [ "name" ] }, "list": { "parameters": { "pageToken": { "type": "string", "description": "A page token, received from a previous `ListManagementDnsZoneBindings` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListManagementDnsZoneBindings` must match the call that provided the page token.", "location": "query" }, "orderBy": { "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "location": "query", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the private cloud to be queried for management DNS zone bindings. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`" }, "pageSize": { "description": "The maximum number of management DNS zone bindings to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "type": "integer", "format": "int32", "location": "query" }, "filter": { "location": "query", "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of Management DNS Zone Bindings, you can exclude the ones named `example-management-dns-zone-binding` by specifying `name != \"example-management-dns-zone-binding\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-management-dns-zone-binding\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-management-dns-zone-binding-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-management-dns-zone-binding-2\") ```", "type": "string" } }, "response": { "$ref": "ListManagementDnsZoneBindingsResponse" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/managementDnsZoneBindings", "path": "v1/{+parent}/managementDnsZoneBindings", "id": "vmwareengine.projects.locations.privateClouds.managementDnsZoneBindings.list", "httpMethod": "GET", "description": "Lists Consumer VPCs bound to Management DNS Zone of a given private cloud." }, "repair": { "id": "vmwareengine.projects.locations.privateClouds.managementDnsZoneBindings.repair", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/managementDnsZoneBindings/{managementDnsZoneBindingsId}:repair", "request": { "$ref": "RepairManagementDnsZoneBindingRequest" }, "response": { "$ref": "Operation" }, "parameters": { "name": { "description": "Required. The resource name of the management DNS zone binding to repair. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-management-dns-zone-binding`", "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/managementDnsZoneBindings/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Retries to create a `ManagementDnsZoneBinding` resource that is in failed state.", "httpMethod": "POST", "parameterOrder": [ "name" ], "path": "v1/{+name}:repair", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateClouds/{privateCloudsId}/managementDnsZoneBindings/{managementDnsZoneBindingsId}", "description": "Updates a `ManagementDnsZoneBinding` resource. Only fields specified in `update_mask` are applied.", "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "id": "vmwareengine.projects.locations.privateClouds.managementDnsZoneBindings.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "updateMask": { "format": "google-fieldmask", "type": "string", "location": "query", "description": "Required. Field mask is used to specify the fields to be overwritten in the `ManagementDnsZoneBinding` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateClouds/[^/]+/managementDnsZoneBindings/[^/]+$", "description": "Output only. The resource name of this binding. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-management-dns-zone-binding`", "type": "string", "location": "path", "required": true }, "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" } }, "httpMethod": "PATCH", "request": { "$ref": "ManagementDnsZoneBinding" }, "path": "v1/{+name}" } } } } }, "networkPolicies": { "resources": { "externalAccessRules": { "methods": { "get": { "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+/externalAccessRules/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the external access firewall rule to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}/externalAccessRules/{externalAccessRulesId}", "description": "Gets details of a single external access rule.", "parameterOrder": [ "name" ], "id": "vmwareengine.projects.locations.networkPolicies.externalAccessRules.get", "response": { "$ref": "ExternalAccessRule" }, "path": "v1/{+name}", "httpMethod": "GET" }, "list": { "id": "vmwareengine.projects.locations.networkPolicies.externalAccessRules.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+$", "description": "Required. The resource name of the network policy to query for external access firewall rules. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-policy`", "location": "path", "required": true, "type": "string" }, "filter": { "location": "query", "type": "string", "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of external access rules, you can exclude the ones named `example-rule` by specifying `name != \"example-rule\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-rule\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-rule-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-rule-2\") ```" }, "pageSize": { "location": "query", "description": "The maximum number of external access rules to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "type": "integer", "format": "int32" }, "orderBy": { "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "type": "string", "location": "query" }, "pageToken": { "description": "A page token, received from a previous `ListExternalAccessRulesRequest` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListExternalAccessRulesRequest` must match the call that provided the page token.", "type": "string", "location": "query" } }, "path": "v1/{+parent}/externalAccessRules", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}/externalAccessRules", "description": "Lists `ExternalAccessRule` resources in the specified network policy.", "response": { "$ref": "ListExternalAccessRulesResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET" }, "create": { "description": "Creates a new external access rule in a given network policy.", "request": { "$ref": "ExternalAccessRule" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "externalAccessRuleId": { "type": "string", "description": "Required. The user-provided identifier of the `ExternalAccessRule` to be created. This identifier must be unique among `ExternalAccessRule` resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)", "location": "query" }, "validateOnly": { "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "type": "boolean", "location": "query" }, "requestId": { "description": "A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string", "location": "query" }, "parent": { "location": "path", "required": true, "description": "Required. The resource name of the network policy to create a new external access firewall rule in. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-policy`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+$" } }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/externalAccessRules", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}/externalAccessRules", "id": "vmwareengine.projects.locations.networkPolicies.externalAccessRules.create", "httpMethod": "POST", "response": { "$ref": "Operation" } }, "delete": { "parameters": { "requestId": { "location": "query", "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "name": { "description": "Required. The resource name of the external access firewall rule to delete. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+/externalAccessRules/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}/externalAccessRules/{externalAccessRulesId}", "id": "vmwareengine.projects.locations.networkPolicies.externalAccessRules.delete", "parameterOrder": [ "name" ], "description": "Deletes a single external access rule.", "path": "v1/{+name}", "httpMethod": "DELETE" }, "patch": { "response": { "$ref": "Operation" }, "request": { "$ref": "ExternalAccessRule" }, "httpMethod": "PATCH", "id": "vmwareengine.projects.locations.networkPolicies.externalAccessRules.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}/externalAccessRules/{externalAccessRulesId}", "parameterOrder": [ "name" ], "parameters": { "requestId": { "type": "string", "location": "query", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "validateOnly": { "description": "Optional. If set to `true`, only validates the request but doesn’t execute the// request. If set to `false`, validates and executes the request.", "location": "query", "type": "boolean" }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "Required. Field mask is used to specify the fields to be overwritten in the `ExternalAccessRule` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+/externalAccessRules/[^/]+$", "description": "Output only. The resource name of this external access rule. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule`", "location": "path", "required": true, "type": "string" } }, "description": "Updates the parameters of a single external access rule. Only fields specified in `update_mask` are applied.", "path": "v1/{+name}" } } } }, "methods": { "create": { "parameters": { "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query" }, "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the location (region) to create the new network policy in. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1`", "type": "string" }, "networkPolicyId": { "type": "string", "location": "query", "description": "Required. The user-provided identifier of the network policy to be created. This identifier must be unique within parent `projects/{my-project}/locations/{us-central1}/networkPolicies` and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)" } }, "description": "Creates a new network policy in a given VMware Engine network of a project and location (region). A new network policy cannot be created if another network policy already exists in the same scope.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "path": "v1/{+parent}/networkPolicies", "id": "vmwareengine.projects.locations.networkPolicies.create", "request": { "$ref": "NetworkPolicy" }, "parameterOrder": [ "parent" ], "httpMethod": "POST", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies" }, "delete": { "response": { "$ref": "Operation" }, "httpMethod": "DELETE", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}", "id": "vmwareengine.projects.locations.networkPolicies.delete", "description": "Deletes a `NetworkPolicy` resource. A network policy cannot be deleted when `NetworkService.state` is set to `RECONCILING` for either its external IP or internet access service.", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the network policy to delete. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-network-policy`", "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+$" }, "requestId": { "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query" } }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "response": { "$ref": "ListNetworkPoliciesResponse" }, "parameters": { "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous `ListNetworkPolicies` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListNetworkPolicies` must match the call that provided the page token." }, "orderBy": { "location": "query", "type": "string", "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported." }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The maximum number of network policies to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500." }, "filter": { "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of network policies, you can exclude the ones named `example-policy` by specifying `name != \"example-policy\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-policy\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-policy-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-policy-2\") ```", "location": "query", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the location (region) to query for network policies. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1`", "type": "string" } }, "path": "v1/{+parent}/networkPolicies", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies", "id": "vmwareengine.projects.locations.networkPolicies.list", "description": "Lists `NetworkPolicy` resources in a specified project and location.", "parameterOrder": [ "parent" ], "httpMethod": "GET" }, "get": { "description": "Retrieves a `NetworkPolicy` resource by its resource name.", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the network policy to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-network-policy`", "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+$", "type": "string" } }, "id": "vmwareengine.projects.locations.networkPolicies.get", "path": "v1/{+name}", "response": { "$ref": "NetworkPolicy" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}", "parameterOrder": [ "name" ] }, "fetchExternalAddresses": { "httpMethod": "GET", "parameterOrder": [ "networkPolicy" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.networkPolicies.fetchExternalAddresses", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}:fetchExternalAddresses", "description": "Lists external IP addresses assigned to VMware workload VMs within the scope of the given network policy.", "response": { "$ref": "FetchNetworkPolicyExternalAddressesResponse" }, "parameters": { "pageToken": { "description": "A page token, received from a previous `FetchNetworkPolicyExternalAddresses` call. Provide this to retrieve the subsequent page. When paginating, all parameters provided to `FetchNetworkPolicyExternalAddresses`, except for `page_size` and `page_token`, must match the call that provided the page token.", "type": "string", "location": "query" }, "networkPolicy": { "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+$", "description": "Required. The resource name of the network policy to query for assigned external IP addresses. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-policy`", "location": "path", "required": true, "type": "string" }, "pageSize": { "type": "integer", "location": "query", "description": "The maximum number of external IP addresses to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "format": "int32" } }, "path": "v1/{+networkPolicy}:fetchExternalAddresses" }, "patch": { "path": "v1/{+name}", "description": "Modifies a `NetworkPolicy` resource. Only the following fields can be updated: `internet_access`, `external_ip`, `edge_services_cidr`. Only fields specified in `updateMask` are applied. When updating a network policy, the external IP network service can only be disabled if there are no external IP addresses present in the scope of the policy. Also, a `NetworkService` cannot be updated when `NetworkService.state` is set to `RECONCILING`. During operation processing, the resource is temporarily in the `ACTIVE` state before the operation fully completes. For that period of time, you can't update the resource. Use the operation status to determine when the processing fully completes.", "parameters": { "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query" }, "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten in the `NetworkPolicy` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "location": "query", "format": "google-fieldmask", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/networkPolicies/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Output only. Identifier. The resource name of this network policy. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-network-policy`" }, "requestId": { "location": "query", "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPolicies/{networkPoliciesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "id": "vmwareengine.projects.locations.networkPolicies.patch", "request": { "$ref": "NetworkPolicy" }, "response": { "$ref": "Operation" } } } }, "nodeTypes": { "methods": { "get": { "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/nodeTypes/[^/]+$", "description": "Required. The resource name of the node type to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-proj/locations/us-central1-a/nodeTypes/standard-72`", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "response": { "$ref": "NodeType" }, "description": "Gets details of a single `NodeType`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/nodeTypes/{nodeTypesId}", "httpMethod": "GET", "id": "vmwareengine.projects.locations.nodeTypes.get", "parameterOrder": [ "name" ] }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "ListNodeTypesResponse" }, "description": "Lists node types", "httpMethod": "GET", "path": "v1/{+parent}/nodeTypes", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/nodeTypes", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the location to be queried for node types. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a`" }, "pageToken": { "type": "string", "description": "A page token, received from a previous `ListNodeTypes` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListNodeTypes` must match the call that provided the page token.", "location": "query" }, "pageSize": { "description": "The maximum number of node types to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "location": "query", "type": "integer", "format": "int32" }, "filter": { "type": "string", "location": "query", "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of node types, you can exclude the ones named `standard-72` by specifying `name != \"standard-72\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"standard-72\") (virtual_cpu_count \u003e 2) ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"standard-96\") AND (virtual_cpu_count \u003e 2) OR (name = \"standard-72\") ```" } }, "id": "vmwareengine.projects.locations.nodeTypes.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "operations": { "methods": { "get": { "id": "vmwareengine.projects.locations.operations.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string" } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "response": { "$ref": "Operation" }, "path": "v1/{+name}" }, "delete": { "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "Empty" }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "id": "vmwareengine.projects.locations.operations.delete", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } } }, "list": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "path": "v1/{+name}/operations", "response": { "$ref": "ListOperationsResponse" }, "id": "vmwareengine.projects.locations.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "parameters": { "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" } } } } }, "dnsBindPermission": { "methods": { "grant": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "POST", "id": "vmwareengine.projects.locations.dnsBindPermission.grant", "parameters": { "name": { "type": "string", "description": "Required. The name of the resource which stores the users/service accounts having the permission to bind to the corresponding intranet VPC of the consumer project. DnsBindPermission is a global resource. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/dnsBindPermission`", "pattern": "^projects/[^/]+/locations/[^/]+/dnsBindPermission$", "location": "path", "required": true } }, "description": "Grants the bind permission to the customer provided principal(user / service account) to bind their DNS zone with the intranet VPC associated with the project. DnsBindPermission is a global resource and location can only be global.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsBindPermission:grant", "request": { "$ref": "GrantDnsBindPermissionRequest" }, "path": "v1/{+name}:grant", "response": { "$ref": "Operation" } }, "revoke": { "id": "vmwareengine.projects.locations.dnsBindPermission.revoke", "path": "v1/{+name}:revoke", "httpMethod": "POST", "description": "Revokes the bind permission from the customer provided principal(user / service account) on the intranet VPC associated with the consumer project. DnsBindPermission is a global resource and location can only be global.", "request": { "$ref": "RevokeDnsBindPermissionRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. The name of the resource which stores the users/service accounts having the permission to bind to the corresponding intranet VPC of the consumer project. DnsBindPermission is a global resource. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/dnsBindPermission`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/dnsBindPermission$", "location": "path", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsBindPermission:revoke" } } }, "networkPeerings": { "methods": { "get": { "id": "vmwareengine.projects.locations.networkPeerings.get", "path": "v1/{+name}", "description": "Retrieves a `NetworkPeering` resource by its resource name. The resource contains details of the network peering, such as peered networks, import and export custom route configurations, and peering state. NetworkPeering is a global resource and location can only be global.", "parameters": { "name": { "description": "Required. The resource name of the network peering to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/networkPeerings/my-peering`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/networkPeerings/[^/]+$" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPeerings/{networkPeeringsId}", "parameterOrder": [ "name" ], "response": { "$ref": "NetworkPeering" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "list": { "parameterOrder": [ "parent" ], "id": "vmwareengine.projects.locations.networkPeerings.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "type": "string", "description": "A page token, received from a previous `ListNetworkPeerings` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListNetworkPeerings` must match the call that provided the page token.", "location": "query" }, "orderBy": { "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The maximum number of network peerings to return in one page. The maximum value is coerced to 1000. The default value of this field is 500." }, "filter": { "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of network peerings, you can exclude the ones named `example-peering` by specifying `name != \"example-peering\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-peering\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-peering-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-peering-2\") ```", "location": "query", "type": "string" }, "parent": { "description": "Required. The resource name of the location (global) to query for network peerings. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global`", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "description": "Lists `NetworkPeering` resources in a given project. NetworkPeering is a global resource and location can only be global.", "response": { "$ref": "ListNetworkPeeringsResponse" }, "path": "v1/{+parent}/networkPeerings", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPeerings" }, "patch": { "description": "Modifies a `NetworkPeering` resource. Only the `description` field can be updated. Only fields specified in `updateMask` are applied. NetworkPeering is a global resource and location can only be global.", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "id": "vmwareengine.projects.locations.networkPeerings.patch", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPeerings/{networkPeeringsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten in the `NetworkPeering` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "type": "string", "format": "google-fieldmask", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/networkPeerings/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Output only. Identifier. The resource name of the network peering. NetworkPeering is a global resource and location can only be global. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/networkPeerings/my-peering`" }, "validateOnly": { "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query", "type": "boolean" }, "requestId": { "location": "query", "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "request": { "$ref": "NetworkPeering" }, "httpMethod": "PATCH", "parameterOrder": [ "name" ] }, "create": { "request": { "$ref": "NetworkPeering" }, "httpMethod": "POST", "id": "vmwareengine.projects.locations.networkPeerings.create", "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPeerings", "path": "v1/{+parent}/networkPeerings", "description": "Creates a new network peering between the peer network and VMware Engine network provided in a `NetworkPeering` resource. NetworkPeering is a global resource and location can only be global.", "parameters": { "requestId": { "location": "query", "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "networkPeeringId": { "location": "query", "type": "string", "description": "Required. The user-provided identifier of the new `NetworkPeering`. This identifier must be unique among `NetworkPeering` resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)" }, "parent": { "description": "Required. The resource name of the location to create the new network peering in. This value is always `global`, because `NetworkPeering` is a global resource. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "validateOnly": { "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query", "type": "boolean" } } }, "delete": { "parameters": { "requestId": { "location": "query", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" }, "name": { "description": "Required. The resource name of the network peering to be deleted. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/networkPeerings/my-peering`", "pattern": "^projects/[^/]+/locations/[^/]+/networkPeerings/[^/]+$", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPeerings/{networkPeeringsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "description": "Deletes a `NetworkPeering` resource. When a network peering is deleted for a VMware Engine network, the peer network becomes inaccessible to that VMware Engine network. NetworkPeering is a global resource and location can only be global.", "path": "v1/{+name}", "id": "vmwareengine.projects.locations.networkPeerings.delete", "httpMethod": "DELETE" } }, "resources": { "peeringRoutes": { "methods": { "list": { "id": "vmwareengine.projects.locations.networkPeerings.peeringRoutes.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of peering routes to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500." }, "parent": { "description": "Required. The resource name of the network peering to retrieve peering routes from. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/networkPeerings/my-peering`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/networkPeerings/[^/]+$", "location": "path", "required": true }, "filter": { "description": "A filter expression that matches resources returned in the response. Currently, only filtering on the `direction` field is supported. To return routes imported from the peer network, provide \"direction=INCOMING\". To return routes exported from the VMware Engine network, provide \"direction=OUTGOING\". Other filter expressions return an error.", "location": "query", "type": "string" }, "pageToken": { "type": "string", "description": "A page token, received from a previous `ListPeeringRoutes` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPeeringRoutes` must match the call that provided the page token.", "location": "query" } }, "response": { "$ref": "ListPeeringRoutesResponse" }, "path": "v1/{+parent}/peeringRoutes", "description": "Lists the network peering routes exchanged over a peering connection. NetworkPeering is a global resource and location can only be global.", "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/networkPeerings/{networkPeeringsId}/peeringRoutes" } } } } }, "vmwareEngineNetworks": { "methods": { "create": { "httpMethod": "POST", "path": "v1/{+parent}/vmwareEngineNetworks", "id": "vmwareengine.projects.locations.vmwareEngineNetworks.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "description": "Creates a new VMware Engine network that can be used by a private cloud.", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The resource name of the location to create the new VMware Engine network in. A VMware Engine network of type `LEGACY` is a regional resource, and a VMware Engine network of type `STANDARD` is a global resource. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" }, "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query" }, "vmwareEngineNetworkId": { "location": "query", "description": "Required. The user-provided identifier of the new VMware Engine network. This identifier must be unique among VMware Engine network resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * For networks of type LEGACY, adheres to the format: `{region-id}-default`. Replace `{region-id}` with the region where you want to create the VMware Engine network. For example, \"us-central1-default\". * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)", "type": "string" }, "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string", "location": "query" } }, "request": { "$ref": "VmwareEngineNetwork" }, "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareEngineNetworks" }, "delete": { "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/vmwareEngineNetworks/[^/]+$", "description": "Required. The resource name of the VMware Engine network to be deleted. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/vmwareEngineNetworks/my-network`", "type": "string" }, "etag": { "description": "Optional. Checksum used to ensure that the user-provided value is up to date before the server processes the request. The server compares provided checksum with the current checksum of the resource. If the user-provided value is out of date, this request returns an `ABORTED` error.", "type": "string", "location": "query" }, "requestId": { "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query" } }, "description": "Deletes a `VmwareEngineNetwork` resource. You can only delete a VMware Engine network after all resources that refer to it are deleted. For example, a private cloud, a network peering, and a network policy can all refer to the same VMware Engine network.", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareEngineNetworks/{vmwareEngineNetworksId}", "id": "vmwareengine.projects.locations.vmwareEngineNetworks.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "DELETE" }, "get": { "path": "v1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the VMware Engine network to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/vmwareEngineNetworks/my-network`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/vmwareEngineNetworks/[^/]+$" } }, "httpMethod": "GET", "response": { "$ref": "VmwareEngineNetwork" }, "description": "Retrieves a `VmwareEngineNetwork` resource by its resource name. The resource contains details of the VMware Engine network, such as its VMware Engine network type, peered networks in a service project, and state (for example, `CREATING`, `ACTIVE`, `DELETING`).", "id": "vmwareengine.projects.locations.vmwareEngineNetworks.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareEngineNetworks/{vmwareEngineNetworksId}" }, "list": { "path": "v1/{+parent}/vmwareEngineNetworks", "description": "Lists `VmwareEngineNetwork` resources in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareEngineNetworks", "httpMethod": "GET", "response": { "$ref": "ListVmwareEngineNetworksResponse" }, "id": "vmwareengine.projects.locations.vmwareEngineNetworks.list", "parameters": { "pageSize": { "location": "query", "description": "The maximum number of results to return in one page. The maximum value is coerced to 1000. The default value of this field is 500.", "format": "int32", "type": "integer" }, "pageToken": { "description": "A page token, received from a previous `ListVmwareEngineNetworks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListVmwareEngineNetworks` must match the call that provided the page token.", "location": "query", "type": "string" }, "parent": { "description": "Required. The resource name of the location to query for VMware Engine networks. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "orderBy": { "type": "string", "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of network peerings, you can exclude the ones named `example-network` by specifying `name != \"example-network\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-network\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-network-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-network-2\") ```" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "response": { "$ref": "Operation" }, "path": "v1/{+name}", "httpMethod": "PATCH", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vmwareEngineNetworks/{vmwareEngineNetworksId}", "description": "Modifies a VMware Engine network resource. Only the following fields can be updated: `description`. Only fields specified in `updateMask` are applied.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.vmwareEngineNetworks.patch", "request": { "$ref": "VmwareEngineNetwork" }, "parameters": { "name": { "description": "Output only. Identifier. The resource name of the VMware Engine network. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/vmwareEngineNetworks/my-network`", "pattern": "^projects/[^/]+/locations/[^/]+/vmwareEngineNetworks/[^/]+$", "type": "string", "location": "path", "required": true }, "requestId": { "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query" }, "updateMask": { "type": "string", "description": "Required. Field mask is used to specify the fields to be overwritten in the VMware Engine network resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. Only the following fields can be updated: `description`.", "format": "google-fieldmask", "location": "query" }, "validateOnly": { "location": "query", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "type": "boolean" } } } } }, "privateConnections": { "resources": { "peeringRoutes": { "methods": { "list": { "path": "v1/{+parent}/peeringRoutes", "description": "Lists the private connection routes exchanged over a peering connection.", "parameters": { "pageSize": { "type": "integer", "format": "int32", "description": "The maximum number of peering routes to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500.", "location": "query" }, "pageToken": { "description": "A page token, received from a previous `ListPrivateConnectionPeeringRoutes` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPrivateConnectionPeeringRoutes` must match the call that provided the page token.", "location": "query", "type": "string" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", "description": "Required. The resource name of the private connection to retrieve peering routes from. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1/privateConnections/my-connection`", "type": "string" } }, "response": { "$ref": "ListPrivateConnectionPeeringRoutesResponse" }, "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}/peeringRoutes", "id": "vmwareengine.projects.locations.privateConnections.peeringRoutes.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] } } } }, "methods": { "list": { "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections", "path": "v1/{+parent}/privateConnections", "description": "Lists `PrivateConnection` resources in a given project and location.", "response": { "$ref": "ListPrivateConnectionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "vmwareengine.projects.locations.privateConnections.list", "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the location to query for private connections. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1`" }, "pageSize": { "location": "query", "description": "The maximum number of private connections to return in one page. The maximum value is coerced to 1000. The default value of this field is 500.", "format": "int32", "type": "integer" }, "pageToken": { "location": "query", "description": "A page token, received from a previous `ListPrivateConnections` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPrivateConnections` must match the call that provided the page token.", "type": "string" }, "orderBy": { "location": "query", "type": "string", "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported." }, "filter": { "type": "string", "location": "query", "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of private connections, you can exclude the ones named `example-connection` by specifying `name != \"example-connection\"`. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-connection\") (createTime \u003e \"2022-09-22T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"example-connection-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"example-connection-2\") ```" } } }, "create": { "parameterOrder": [ "parent" ], "parameters": { "parent": { "description": "Required. The resource name of the location to create the new private connection in. Private connection is a regional resource. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" }, "privateConnectionId": { "location": "query", "description": "Required. The user-provided identifier of the new private connection. This identifier must be unique among private connection resources within the parent and becomes the final token in the name URI. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)", "type": "string" }, "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "location": "query" }, "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string", "location": "query" } }, "path": "v1/{+parent}/privateConnections", "response": { "$ref": "Operation" }, "httpMethod": "POST", "request": { "$ref": "PrivateConnection" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections", "description": "Creates a new private connection that can be used for accessing private Clouds.", "id": "vmwareengine.projects.locations.privateConnections.create" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. The resource name of the private connection to be deleted. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateConnections/my-connection`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", "location": "path", "required": true }, "requestId": { "location": "query", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" } }, "path": "v1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}", "id": "vmwareengine.projects.locations.privateConnections.delete", "httpMethod": "DELETE", "description": "Deletes a `PrivateConnection` resource. When a private connection is deleted for a VMware Engine network, the connected network becomes inaccessible to that VMware Engine network.", "response": { "$ref": "Operation" } }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "parameterOrder": [ "name" ], "parameters": { "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten in the `PrivateConnection` resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "location": "query", "type": "string", "format": "google-fieldmask" }, "validateOnly": { "location": "query", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "type": "boolean" }, "name": { "description": "Output only. The resource name of the private connection. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateConnections/my-connection`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", "location": "path", "required": true }, "requestId": { "location": "query", "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}", "response": { "$ref": "Operation" }, "id": "vmwareengine.projects.locations.privateConnections.patch", "path": "v1/{+name}", "request": { "$ref": "PrivateConnection" }, "description": "Modifies a `PrivateConnection` resource. Only `description` and `routing_mode` fields can be updated. Only fields specified in `updateMask` are applied." }, "get": { "path": "v1/{+name}", "description": "Retrieves a `PrivateConnection` resource by its resource name. The resource contains details of the private connection, such as connected network, routing mode and state.", "parameterOrder": [ "name" ], "id": "vmwareengine.projects.locations.privateConnections.get", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/privateConnections/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the private connection to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateConnections/my-connection`" } }, "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/privateConnections/{privateConnectionsId}", "response": { "$ref": "PrivateConnection" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "announcements": { "methods": { "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/announcements/{announcementsId}", "id": "vmwareengine.projects.locations.announcements.get", "description": "Retrieves a `Announcement` by its resource name.", "parameters": { "name": { "description": "Required. The resource name of the announcement to retrieve. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1-a/announcements/announcement-uuid`", "pattern": "^projects/[^/]+/locations/[^/]+/announcements/[^/]+$", "location": "path", "required": true, "type": "string" } }, "path": "v1/{+name}", "response": { "$ref": "Announcement" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET" }, "list": { "parameterOrder": [ "parent" ], "path": "v1/{+parent}/announcements", "id": "vmwareengine.projects.locations.announcements.list", "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/announcements", "parameters": { "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The maximum number of announcements to return in one page. The service may return fewer than this value. The maximum value is coerced to 1000. The default value of this field is 500." }, "orderBy": { "location": "query", "description": "Sorts list results by a certain order. By default, returned results are ordered by `name` in ascending order. You can also sort results in descending order based on the `name` value using `orderBy=\"name desc\"`. Currently, only ordering by `name` is supported.", "type": "string" }, "parent": { "type": "string", "description": "Required. The resource name of the location to be queried for announcements. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1-a`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous `ListAnnouncements` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAnnouncements` must match the call that provided the page token." }, "filter": { "description": "A filter expression that matches resources returned in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be `=`, `!=`, `\u003e`, or `\u003c`. For example, if you are filtering a list of announcement runs, you can exclude the ones named `example-announcement` by specifying `name != \"example-announcement\"`. You can also filter nested fields. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (name = \"example-announcement\") (createTime \u003e \"2021-04-12T08:15:10.40Z\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (name = \"announcement-1\") AND (createTime \u003e \"2021-04-12T08:15:10.40Z\") OR (name = \"announcement-2\") ```", "type": "string", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListAnnouncementsResponse" }, "description": "Lists `Announcements` for a given region and project" } } } }, "methods": { "getDnsBindPermission": { "path": "v1/{+name}", "description": "Gets all the principals having bind permission on the intranet VPC associated with the consumer project granted by the Grant API. DnsBindPermission is a global resource and location can only be global.", "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsBindPermission", "parameters": { "name": { "description": "Required. The name of the resource which stores the users/service accounts having the permission to bind to the corresponding intranet VPC of the consumer project. DnsBindPermission is a global resource. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/dnsBindPermission`", "pattern": "^projects/[^/]+/locations/[^/]+/dnsBindPermission$", "location": "path", "required": true, "type": "string" } }, "response": { "$ref": "DnsBindPermission" }, "id": "vmwareengine.projects.locations.getDnsBindPermission", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "id": "vmwareengine.projects.locations.list", "parameterOrder": [ "name" ], "parameters": { "filter": { "location": "query", "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).", "type": "string" }, "pageSize": { "description": "The maximum number of results to return. If not set, the service selects a default.", "location": "query", "type": "integer", "format": "int32" }, "name": { "type": "string", "location": "path", "required": true, "description": "The resource that owns the locations collection, if applicable.", "pattern": "^projects/[^/]+$" }, "pageToken": { "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "type": "string", "location": "query" }, "extraLocationTypes": { "location": "query", "repeated": true, "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListLocationsResponse" }, "path": "v1/{+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": "v1/projects/{projectsId}/locations" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "id": "vmwareengine.projects.locations.get", "path": "v1/{+name}", "response": { "$ref": "Location" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Resource name for the location.", "location": "path", "required": true, "type": "string" } }, "description": "Gets information about a location." } } } } } }, "servicePath": "", "description": "The Google VMware Engine API lets you programmatically manage VMware environments.", "rootUrl": "https://vmwareengine.googleapis.com/", "revision": "20260608", "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." } } } }, "ownerName": "Google", "documentationLink": "https://cloud.google.com/solutions/vmware-as-a-service", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "kind": "discovery#restDescription", "basePath": "", "parameters": { "$.xgafv": { "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query", "type": "string", "enum": [ "1", "2" ], "description": "V1 error format." }, "quotaUser": { "location": "query", "type": "string", "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." }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." }, "prettyPrint": { "default": "true", "type": "boolean", "location": "query", "description": "Returns response with indentations and line breaks." }, "callback": { "type": "string", "location": "query", "description": "JSONP" }, "fields": { "description": "Selector specifying which fields to include in a partial response.", "type": "string", "location": "query" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "alt": { "description": "Data format for response.", "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" ], "type": "string", "enum": [ "json", "media", "proto" ], "default": "json" }, "uploadType": { "location": "query", "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "access_token": { "type": "string", "location": "query", "description": "OAuth access token." }, "key": { "location": "query", "type": "string", "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." } }, "fullyEncodeReservedExpansion": true, "schemas": { "ListPrivateCloudsResponse": { "properties": { "unreachable": { "items": { "type": "string" }, "type": "array", "description": "Locations that could not be reached when making an aggregated query using wildcards." }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "privateClouds": { "items": { "$ref": "PrivateCloud" }, "type": "array", "description": "A list of private clouds." } }, "id": "ListPrivateCloudsResponse", "description": "Response message for VmwareEngine.ListPrivateClouds", "type": "object" }, "OperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "OperationMetadata", "type": "object", "properties": { "statusMessage": { "type": "string", "description": "Output only. Human-readable status of the operation, if any.", "readOnly": true }, "verb": { "readOnly": true, "description": "Output only. Name of the verb executed by the operation.", "type": "string" }, "createTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. The time the operation was created." }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "apiVersion": { "type": "string", "description": "Output only. API version used to start the operation.", "readOnly": true }, "requestedCancellation": { "description": "Output only. True if the user has requested cancellation of the operation; false otherwise. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", "readOnly": true, "type": "boolean" }, "endTime": { "readOnly": true, "description": "Output only. The time the operation finished running.", "type": "string", "format": "google-datetime" } } }, "TimeOfDay": { "id": "TimeOfDay", "properties": { "hours": { "format": "int32", "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "type": "integer" }, "minutes": { "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "nanos": { "type": "integer", "format": "int32", "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999." }, "seconds": { "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32", "type": "integer" } }, "type": "object", "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`." }, "NetworkConfig": { "description": "Network configuration in the consumer project with which the peering has to be done.", "type": "object", "properties": { "managementCidr": { "description": "Required. Management CIDR used by VMware management appliances.", "type": "string" }, "vmwareEngineNetworkCanonical": { "type": "string", "description": "Output only. The canonical name of the VMware Engine network in the form: `projects/{project_number}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}`", "readOnly": true }, "dnsServerIp": { "type": "string", "readOnly": true, "description": "Output only. DNS Server IP of the Private Cloud. All DNS queries can be forwarded to this address for name resolution of Private Cloud's management entities like vCenter, NSX-T Manager and ESXi hosts." }, "vmwareEngineNetwork": { "type": "string", "description": "Optional. The relative resource name of the VMware Engine network attached to the private cloud. Specify the name in the following form: `projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}` where `{project}` can either be a project number or a project ID." }, "managementIpAddressLayoutVersion": { "description": "Output only. The IP address layout version of the management IP address range. Possible versions include: * `managementIpAddressLayoutVersion=1`: Indicates the legacy IP address layout used by some existing private clouds. This is no longer supported for new private clouds as it does not support all features. * `managementIpAddressLayoutVersion=2`: Indicates the latest IP address layout used by all newly created private clouds. This version supports all current features.", "type": "integer", "readOnly": true, "format": "int32" } }, "id": "NetworkConfig" }, "Upgrade": { "description": "Describes Private cloud Upgrade.", "properties": { "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Output Only. Last update time of this resource." }, "type": { "enumDescriptions": [ "The default value. This value should never be used.", "Upgrade of vmware components when a major version is available. 7.0u2 -\u003e 7.0u3.", "Patching of vmware components when a minor version is available. 7.0u2c -\u003e 7.0u2d.", "Workarounds are hotfixes for vulnerabilities or issues applied to mitigate the known vulnerability or issue until a patch or update is released. The description of the upgrade will have more details.", "Firmware upgrade for VMware product used in the private cloud.", "Switch upgrade.", "The upgrade type that doesn't fall into any other category.", "Infrastructure upgrade in BM node maintenance." ], "readOnly": true, "description": "Output only. Output Only. The type of upgrade.", "type": "string", "enum": [ "TYPE_UNSPECIFIED", "VSPHERE_UPGRADE", "VSPHERE_PATCH", "WORKAROUND", "FIRMWARE_UPGRADE", "SWITCH_UPGRADE", "OTHER", "INFRASTRUCTURE_UPGRADE" ] }, "version": { "type": "string", "description": "Output only. ", "readOnly": true }, "uid": { "readOnly": true, "type": "string", "description": "Output only. System-generated unique identifier for the resource." }, "componentUpgrades": { "items": { "$ref": "VmwareUpgradeComponent" }, "description": "Output only. Output Only. The list of component upgrades.", "readOnly": true, "type": "array" }, "state": { "description": "Output only. The current state of the upgrade.", "enumDescriptions": [ "The default value. This value should never be used.", "The upgrade is scheduled but not started yet.", "The upgrade is currently in progress and has not completed yet.", "The upgrade completed successfully.", "The upgrade is currently paused.", "The upgrade failed.", "The upgrade is in process of being canceled.", "The upgrade is canceled.", "The upgrade is in process of being rescheduled." ], "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "SCHEDULED", "ONGOING", "SUCCEEDED", "PAUSED", "FAILED", "CANCELLING", "CANCELLED", "RESCHEDULING" ] }, "targetVersion": { "description": "Output only. Output Only. The target version", "readOnly": true, "type": "string" }, "schedule": { "description": "Schedule details for the upgrade.", "$ref": "Schedule" }, "createTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Output Only. Creation time of this resource." }, "name": { "type": "string", "description": "Output only. Identifier. The resource name of the private cloud `Upgrade`. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade`", "readOnly": true }, "startVersion": { "type": "string", "readOnly": true, "description": "Output only. Output Only. The start version" }, "estimatedDuration": { "type": "string", "format": "google-duration", "description": "Output only. Output Only. The estimated total duration of the upgrade. This information can be used to plan or schedule upgrades to minimize disruptions. Please note that the estimated duration is only an estimate. The actual upgrade duration may vary.", "readOnly": true }, "endTime": { "readOnly": true, "description": "Output only. Output Only. End time of the upgrade.", "type": "string", "format": "google-datetime" }, "description": { "type": "string", "description": "Output only. Output Only. The description of the upgrade. This is used to provide additional information about the private cloud upgrade, such as the upgrade's purpose, the changes included in the upgrade, or any other relevant information about the upgrade.", "readOnly": true }, "etag": { "description": "The etag for the upgrade resource. If this is provided on update, it must match the server's etag.", "type": "string" } }, "type": "object", "id": "Upgrade" }, "ExternalAccessRule": { "properties": { "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "UPDATING", "DELETING" ], "description": "Output only. The state of the resource.", "readOnly": true, "enumDescriptions": [ "The default value. This value is used if the state is omitted.", "The rule is ready.", "The rule is being created.", "The rule is being updated.", "The rule is being deleted." ] }, "updateTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Last update time of this resource." }, "action": { "enumDescriptions": [ "Defaults to allow.", "Allows connections that match the other specified components.", "Blocks connections that match the other specified components." ], "description": "The action that the external access rule performs.", "type": "string", "enum": [ "ACTION_UNSPECIFIED", "ALLOW", "DENY" ] }, "destinationPorts": { "items": { "type": "string" }, "description": "A list of destination ports to which the external access rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. For example: `[\"22\"]`, `[\"80\",\"443\"]`, or `[\"12345-12349\"]`. To match all destination ports, specify `[\"0-65535\"]`.", "type": "array" }, "createTime": { "readOnly": true, "description": "Output only. Creation time of this resource.", "type": "string", "format": "google-datetime" }, "sourceIpRanges": { "type": "array", "items": { "$ref": "IpRange" }, "description": "If source ranges are specified, the external access rule applies only to traffic that has a source IP address in these ranges. These ranges can either be expressed in the CIDR format or as an IP address. As only inbound rules are supported, `ExternalAddress` resources cannot be the source IP addresses of an external access rule. To match all source addresses, specify `0.0.0.0/0`." }, "description": { "description": "User-provided description for this external access rule.", "type": "string" }, "sourcePorts": { "type": "array", "description": "A list of source ports to which the external access rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. For example: `[\"22\"]`, `[\"80\",\"443\"]`, or `[\"12345-12349\"]`. To match all source ports, specify `[\"0-65535\"]`.", "items": { "type": "string" } }, "name": { "type": "string", "readOnly": true, "description": "Output only. The resource name of this external access rule. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule`" }, "priority": { "description": "External access rule priority, which determines the external access rule to use when multiple rules apply. If multiple rules have the same priority, their ordering is non-deterministic. If specific ordering is required, assign unique priorities to enforce such ordering. The external access rule priority is an integer from 100 to 4096, both inclusive. Lower integers indicate higher precedence. For example, a rule with priority `100` has higher precedence than a rule with priority `101`.", "format": "int32", "type": "integer" }, "ipProtocol": { "type": "string", "description": "The IP protocol to which the external access rule applies. This value can be one of the following three protocol strings (not case-sensitive): `tcp`, `udp`, or `icmp`." }, "uid": { "description": "Output only. System-generated unique identifier for the resource.", "type": "string", "readOnly": true }, "destinationIpRanges": { "items": { "$ref": "IpRange" }, "description": "If destination ranges are specified, the external access rule applies only to the traffic that has a destination IP address in these ranges. The specified IP addresses must have reserved external IP addresses in the scope of the parent network policy. To match all external IP addresses in the scope of the parent network policy, specify `0.0.0.0/0`. To match a specific external IP address, specify it using the `IpRange.external_address` property.", "type": "array" } }, "description": "External access firewall rules for filtering incoming traffic destined to `ExternalAddress` resources.", "type": "object", "id": "ExternalAccessRule" }, "HcxActivationKey": { "type": "object", "properties": { "name": { "description": "Output only. The resource name of this HcxActivationKey. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateClouds/my-cloud/hcxActivationKeys/my-key`", "readOnly": true, "type": "string" }, "activationKey": { "description": "Output only. HCX activation key.", "type": "string", "readOnly": true }, "state": { "enumDescriptions": [ "Unspecified state.", "State of a newly generated activation key.", "State of key when it has been used to activate HCX appliance.", "State of key when it is being created." ], "readOnly": true, "description": "Output only. State of HCX activation key.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "AVAILABLE", "CONSUMED", "CREATING" ] }, "uid": { "type": "string", "description": "Output only. System-generated unique identifier for the resource.", "readOnly": true }, "createTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Creation time of HCX activation key." } }, "id": "HcxActivationKey", "description": "HCX activation key. A default key is created during private cloud provisioning, but this behavior is subject to change and you should always verify active keys. Use VmwareEngine.ListHcxActivationKeys to retrieve existing keys and VmwareEngine.CreateHcxActivationKey to create new ones." }, "TimeWindow": { "type": "object", "id": "TimeWindow", "properties": { "duration": { "type": "string", "description": "Required. The duration of the window. The max allowed duration for any window is 24 hours.", "format": "google-duration" }, "startTime": { "$ref": "TimeOfDay", "description": "Required. Time in UTC when the window starts." }, "dayOfWeek": { "type": "string", "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "description": "Required. Day of the week for this window.", "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ] } }, "description": "Represents the time window to perform upgrade activities." }, "ListLoggingServersResponse": { "properties": { "unreachable": { "description": "Locations that could not be reached when making an aggregated query using wildcards.", "items": { "type": "string" }, "type": "array" }, "loggingServers": { "description": "A list of Logging Servers.", "type": "array", "items": { "$ref": "LoggingServer" } }, "nextPageToken": { "description": "A token, which can be send as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "id": "ListLoggingServersResponse", "description": "Response message for VmwareEngine.ListLoggingServers", "type": "object" }, "Credentials": { "type": "object", "id": "Credentials", "description": "Credentials for a private cloud.", "properties": { "username": { "type": "string", "description": "Initial username." }, "password": { "description": "Initial password.", "type": "string" } } }, "ListDatastoresResponse": { "id": "ListDatastoresResponse", "type": "object", "properties": { "unreachable": { "description": "Unreachable resources.", "items": { "type": "string" }, "type": "array" }, "datastores": { "description": "A list of Datastores.", "items": { "$ref": "Datastore" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Response message for VmwareEngine.ListDatastores" }, "ManagementDnsZoneBinding": { "description": "Represents a binding between a network and the management DNS zone. A management DNS zone is the Cloud DNS cross-project binding zone that VMware Engine creates for each private cloud. It contains FQDNs and corresponding IP addresses for the private cloud's ESXi hosts and management VM appliances like vCenter and NSX Manager.", "id": "ManagementDnsZoneBinding", "type": "object", "properties": { "uid": { "description": "Output only. System-generated unique identifier for the resource.", "type": "string", "readOnly": true }, "vmwareEngineNetwork": { "description": "Network to bind is a VMware Engine network. Specify the name in the following form for VMware engine network: `projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}`. `{project}` can either be a project number or a project ID.", "type": "string" }, "vpcNetwork": { "type": "string", "description": "Network to bind is a standard consumer VPC. Specify the name in the following form for consumer VPC network: `projects/{project}/global/networks/{network_id}`. `{project}` can either be a project number or a project ID." }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Creation time of this resource." }, "state": { "description": "Output only. The state of the resource.", "enumDescriptions": [ "The default value. This value should never be used.", "The binding is ready.", "The binding is being created.", "The binding is being updated.", "The binding is being deleted.", "The binding has failed." ], "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "UPDATING", "DELETING", "FAILED" ] }, "description": { "description": "User-provided description for this resource.", "type": "string" }, "updateTime": { "type": "string", "format": "google-datetime", "description": "Output only. Last update time of this resource.", "readOnly": true }, "name": { "type": "string", "readOnly": true, "description": "Output only. The resource name of this binding. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/managementDnsZoneBindings/my-management-dns-zone-binding`" } } }, "ListSubnetsResponse": { "properties": { "subnets": { "type": "array", "description": "A list of subnets.", "items": { "$ref": "Subnet" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached when making an aggregated query using wildcards.", "type": "array" } }, "description": "Response message for VmwareEngine.ListSubnets", "type": "object", "id": "ListSubnetsResponse" }, "NetworkPeering": { "id": "NetworkPeering", "type": "object", "description": "Details of a network peering.", "properties": { "peerMtu": { "format": "int32", "type": "integer", "description": "Optional. Maximum transmission unit (MTU) in bytes. The default value is `1500`. If a value of `0` is provided for this field, VMware Engine uses the default value instead." }, "peerNetworkType": { "description": "Required. The type of the network to peer with the VMware Engine network.", "enumDescriptions": [ "Unspecified", "Peering connection used for connecting to another VPC network established by the same user. For example, a peering connection to another VPC network in the same project or to an on-premises network.", "Peering connection used for connecting to another VMware Engine network.", "Peering connection used for establishing [private services access](https://cloud.google.com/vpc/docs/private-services-access).", "Peering connection used for connecting to NetApp Cloud Volumes.", "Peering connection used for connecting to third-party services. Most third-party services require manual setup of reverse peering on the VPC network associated with the third-party service.", "Peering connection used for connecting to Dell PowerScale Filers", "Peering connection used for connecting to Google Cloud NetApp Volumes.", "Peering connection used for connecting to Google Cloud Filestore Instances." ], "type": "string", "enum": [ "PEER_NETWORK_TYPE_UNSPECIFIED", "STANDARD", "VMWARE_ENGINE_NETWORK", "PRIVATE_SERVICES_ACCESS", "NETAPP_CLOUD_VOLUMES", "THIRD_PARTY_SERVICE", "DELL_POWERSCALE", "GOOGLE_CLOUD_NETAPP_VOLUMES", "GOOGLE_CLOUD_FILESTORE_INSTANCES" ] }, "peerNetwork": { "type": "string", "description": "Required. The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the `peer_network_type` is VMWARE_ENGINE_NETWORK, specify the name in the form: `projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}`. Otherwise specify the name in the form: `projects/{project}/global/networks/{network_id}`, where `{project}` can either be a project number or a project ID." }, "uid": { "description": "Output only. System-generated unique identifier for the resource.", "type": "string", "readOnly": true }, "state": { "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "INACTIVE", "ACTIVE", "CREATING", "DELETING" ], "description": "Output only. State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.", "enumDescriptions": [ "Unspecified network peering state. This is the default value.", "The peering is not active.", "The peering is active.", "The peering is being created.", "The peering is being deleted." ] }, "exportCustomRoutesWithPublicIp": { "type": "boolean", "description": "Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field." }, "importCustomRoutes": { "description": "Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.", "type": "boolean" }, "importCustomRoutesWithPublicIp": { "description": "Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.", "type": "boolean" }, "name": { "type": "string", "description": "Output only. Identifier. The resource name of the network peering. NetworkPeering is a global resource and location can only be global. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/networkPeerings/my-peering`", "readOnly": true }, "createTime": { "description": "Output only. Creation time of this resource.", "format": "google-datetime", "readOnly": true, "type": "string" }, "exportCustomRoutes": { "description": "Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.", "type": "boolean" }, "vmwareEngineNetwork": { "type": "string", "description": "Required. The relative resource name of the VMware Engine network. Specify the name in the following form: `projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}` where `{project}` can either be a project number or a project ID." }, "exchangeSubnetRoutes": { "type": "boolean", "description": "Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'." }, "description": { "type": "string", "description": "Optional. User-provided description for this network peering." }, "stateDetails": { "readOnly": true, "description": "Output only. Output Only. Details about the current state of the network peering.", "type": "string" }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Last update time of this resource." } } }, "UnmountDatastoreRequest": { "description": "Unmount Datastore Request messag", "id": "UnmountDatastoreRequest", "type": "object", "properties": { "datastore": { "type": "string", "description": "Required. The resource name of the datastore to unmount. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/datastores/my-datastore`" }, "validateOnly": { "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request.", "type": "boolean" }, "requestId": { "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" } } }, "ThirdPartyFileService": { "description": "Third party file service configuration", "id": "ThirdPartyFileService", "type": "object", "properties": { "network": { "description": "Required. Required to identify vpc peering used for NFS access network name of NFS's vpc e.g. projects/project-id/global/networks/my-network_id", "type": "string" }, "servers": { "description": "Required. Server IP addresses of the NFS file service. NFS v3, provide a single IP address or DNS name. Multiple servers can be supported in future when NFS 4.1 protocol support is enabled.", "type": "array", "items": { "type": "string" } }, "fileShare": { "description": "Required. Required Mount Folder name", "type": "string" } } }, "DnsBindPermission": { "properties": { "name": { "description": "Required. Output only. The name of the resource which stores the users/service accounts having the permission to bind to the corresponding intranet VPC of the consumer project. DnsBindPermission is a global resource and location can only be global. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/dnsBindPermission`", "readOnly": true, "type": "string" }, "principals": { "readOnly": true, "description": "Output only. Users/Service accounts which have access for binding on the intranet VPC project corresponding to the consumer project.", "items": { "$ref": "Principal" }, "type": "array" } }, "type": "object", "id": "DnsBindPermission", "description": "DnsBindPermission resource that contains the accounts having the consumer DNS bind permission on the corresponding intranet VPC of the consumer project." }, "EncryptionConfig": { "id": "EncryptionConfig", "description": "Encryption configuration for a private cloud.", "properties": { "cryptoKeyName": { "type": "string", "description": "Optional. The resource name of the Cloud KMS key to be used for CMEK encryption. The format of this field is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. The key must be in the same region as the private cloud. This key is used for wrapping the key-encrypting key of vSAN clusters. This field must be provided when `type` is `CMEK` or `LEGACY_CMEK`, and must not be set when `type` is `OTHER`." }, "type": { "description": "Required. The encryption type of the private cloud.", "enumDescriptions": [ "The default value. This value should never be used.", "Customer-managed encryption keys (CMEK).", "Legacy customer-managed encryption keys (CMEK).", "Other encryption types, such as self-managed external KMS." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "CMEK", "LEGACY_CMEK", "OTHER" ] } }, "type": "object" }, "Subnet": { "properties": { "type": { "readOnly": true, "type": "string", "description": "Output only. The type of the subnet. For example \"management\" or \"userDefined\"." }, "vlanId": { "type": "integer", "format": "int32", "description": "Output only. VLAN ID of the VLAN on which the subnet is configured", "readOnly": true }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "UPDATING", "DELETING", "RECONCILING", "FAILED" ], "readOnly": true, "description": "Output only. The state of the resource.", "enumDescriptions": [ "The default value. This value should never be used.", "The subnet is ready.", "The subnet is being created.", "The subnet is being updated.", "The subnet is being deleted.", "Changes requested in the last operation are being propagated.", "Last operation on the subnet did not succeed. Subnet's payload is reverted back to its most recent working state." ] }, "gatewayIp": { "type": "string", "description": "The IP address of the gateway of this subnet. Must fall within the IP prefix defined above." }, "name": { "type": "string", "readOnly": true, "description": "Output only. Identifier. The resource name of this subnet. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/subnets/my-subnet`" }, "ipCidrRange": { "type": "string", "description": "The IP address range of the subnet in CIDR format '10.0.0.0/24'." } }, "description": "Subnet in a private cloud. Either `management` subnets (such as vMotion) that are read-only, or `userDefined`, which can also be updated.", "type": "object", "id": "Subnet" }, "FetchNetworkPolicyExternalAddressesResponse": { "type": "object", "properties": { "externalAddresses": { "type": "array", "description": "A list of external IP addresses assigned to VMware workload VMs within the scope of the given network policy.", "items": { "$ref": "ExternalAddress" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "description": "Response message for VmwareEngine.FetchNetworkPolicyExternalAddresses", "id": "FetchNetworkPolicyExternalAddressesResponse" }, "Announcement": { "description": "Announcement for the resources of Vmware Engine.", "id": "Announcement", "type": "object", "properties": { "createTime": { "type": "string", "description": "Output only. Creation time of this resource. It also serves as start time of notification.", "readOnly": true, "format": "google-datetime" }, "description": { "readOnly": true, "type": "string", "description": "Output only. Description of the announcement." }, "name": { "readOnly": true, "type": "string", "description": "Output only. The resource name of the announcement. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-west1-a/announcements/my-announcement-id`" }, "cluster": { "description": "A Cluster resource name.", "type": "string" }, "activityType": { "type": "string", "description": "Optional. Activity type of the announcement There can be only one active announcement for a given activity type and target resource." }, "state": { "enumDescriptions": [ "The default value. This value should never be used.", "Active announcement which should be visible to user.", "Inactive announcement which should not be visible to user.", "Announcement which is being deleted", "Announcement which being created" ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "INACTIVE", "DELETING", "CREATING" ], "readOnly": true, "description": "Output only. State of the resource. New values may be added to this enum when appropriate." }, "metadata": { "description": "Output only. Additional structured details about this announcement.", "additionalProperties": { "type": "string" }, "type": "object", "readOnly": true }, "code": { "description": "Required. Code of the announcement. Indicates the presence of a VMware Engine related announcement and corresponds to a related message in the `description` field.", "type": "string" }, "privateCloud": { "type": "string", "description": "A Private Cloud resource name." }, "updateTime": { "type": "string", "description": "Output only. Last update time of this resource.", "format": "google-datetime", "readOnly": true }, "targetResourceType": { "description": "Output only. Target Resource Type defines the type of the target for the announcement", "readOnly": true, "type": "string" } } }, "NodeType": { "properties": { "diskSizeGb": { "type": "integer", "description": "Output only. The amount of storage available, defined in GB.", "readOnly": true, "format": "int32" }, "nodeTypeId": { "description": "Output only. The canonical identifier of the node type (corresponds to the `NodeType`). For example: standard-72.", "readOnly": true, "type": "string" }, "memoryGb": { "type": "integer", "format": "int32", "readOnly": true, "description": "Output only. The amount of physical memory available, defined in GB." }, "displayName": { "description": "Output only. The friendly name for this node type. For example: ve1-standard-72", "readOnly": true, "type": "string" }, "kind": { "enumDescriptions": [ "The default value. This value should never be used.", "Standard HCI node.", "Storage only Node." ], "type": "string", "enum": [ "KIND_UNSPECIFIED", "STANDARD", "STORAGE_ONLY" ], "readOnly": true, "description": "Output only. The type of the resource." }, "families": { "readOnly": true, "items": { "type": "string" }, "description": "Output only. Families of the node type. For node types to be in the same cluster they must share at least one element in the `families`.", "type": "array" }, "capabilities": { "readOnly": true, "items": { "enumDescriptions": [ "The default value. This value is used if the capability is omitted or unknown.", "This node type supports stretch clusters." ], "type": "string", "enum": [ "CAPABILITY_UNSPECIFIED", "STRETCHED_CLUSTERS" ] }, "description": "Output only. Capabilities of this node type.", "type": "array" }, "virtualCpuCount": { "format": "int32", "type": "integer", "description": "Output only. The total number of virtual CPUs in a single node.", "readOnly": true }, "totalCoreCount": { "type": "integer", "description": "Output only. The total number of CPU cores in a single node.", "format": "int32", "readOnly": true }, "name": { "type": "string", "description": "Output only. The resource name of this node type. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-proj/locations/us-central1-a/nodeTypes/standard-72`", "readOnly": true }, "availableCustomCoreCounts": { "type": "array", "items": { "type": "integer", "format": "int32" }, "readOnly": true, "description": "Output only. List of possible values of custom core count." } }, "type": "object", "description": "Describes node type.", "id": "NodeType" }, "VpcNetwork": { "type": "object", "properties": { "network": { "description": "Output only. The relative resource name of the service VPC network this VMware Engine network is attached to. For example: `projects/123123/global/networks/my-network`", "readOnly": true, "type": "string" }, "type": { "description": "Output only. Type of VPC network (INTRANET, INTERNET, or GOOGLE_CLOUD)", "readOnly": true, "enumDescriptions": [ "The default value. This value should never be used.", "VPC network that will be peered with a consumer VPC network or the intranet VPC of another VMware Engine network. Access a private cloud through Compute Engine VMs on a peered VPC network or an on-premises resource connected to a peered consumer VPC network.", "VPC network used for internet access to and from a private cloud.", "VPC network used for access to Google Cloud services like Cloud Storage." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "INTRANET", "INTERNET", "GOOGLE_CLOUD" ] } }, "description": "Represents a VMware Engine VPC network that is managed by a VMware Engine network resource.", "id": "VpcNetwork" }, "TestIamPermissionsResponse": { "id": "TestIamPermissionsResponse", "properties": { "permissions": { "items": { "type": "string" }, "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "type": "array" } }, "description": "Response message for `TestIamPermissions` method.", "type": "object" }, "Datastore": { "type": "object", "description": "Represents a datastore resource.", "properties": { "nfsDatastore": { "description": "Required. Settings for the NFS datastore.", "$ref": "NfsDatastore" }, "updateTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Last update time of this resource.", "type": "string" }, "clusters": { "readOnly": true, "items": { "type": "string" }, "type": "array", "description": "Output only. Clusters to which the datastore is attached." }, "state": { "readOnly": true, "description": "Output only. The state of the Datastore.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "UPDATING", "DELETING" ], "enumDescriptions": [ "The default value. This value should never be used.", "The NFS volume is being created.", "The NFS volume is active.", "The NFS volume is being updated.", "The NFS volume is being deleted." ] }, "createTime": { "description": "Output only. Creation time of this resource.", "type": "string", "format": "google-datetime", "readOnly": true }, "uid": { "type": "string", "readOnly": true, "description": "Output only. System-generated unique identifier for the resource." }, "etag": { "type": "string", "description": "Optional. Checksum that may be sent on update and delete requests to ensure that the user-provided value is up to date before the server processes a request. The server computes checksums based on the value of other fields in the request." }, "name": { "type": "string", "description": "Output only. Identifier. The resource name of this datastore. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/datastores/datastore`", "readOnly": true }, "description": { "description": "Optional. User-provided description for this datastore", "type": "string" } }, "id": "Datastore" }, "Expr": { "id": "Expr", "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "type": "object", "properties": { "location": { "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.", "type": "string" }, "expression": { "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "description": { "type": "string", "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI." }, "title": { "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.", "type": "string" } } }, "VmwareUpgradeComponent": { "properties": { "componentType": { "description": "Output only. Type of component", "enumDescriptions": [ "The default value. This value should never be used.", "vcenter", "esxi nodes + transport nodes", "nsxt upgrade coordinator", "nsxt edges cluster", "nsxt managers/management plane", "hcx", "VSAN cluster", "DVS switch", "Nameserver VMs", "KMS VM used for vsan encryption", "witness VM in case of stretch PC", "nsxt", "Cluster is used in case of BM", "VMware Tools." ], "readOnly": true, "type": "string", "enum": [ "VMWARE_COMPONENT_TYPE_UNSPECIFIED", "VCENTER", "ESXI", "NSXT_UC", "NSXT_EDGE", "NSXT_MGR", "HCX", "VSAN", "DVS", "NAMESERVER_VM", "KMS_VM", "WITNESS_VM", "NSXT", "CLUSTER", "VM_TOOLS" ] }, "state": { "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "RUNNING", "PAUSED", "SUCCEEDED", "FAILED", "NOT_STARTED", "NOT_APPLICABLE" ], "description": "Output only. Component's upgrade state.", "enumDescriptions": [ "The default value. This value should never be used.", "Component's upgrade is in progress", "The component's upgrade is paused. Will be resumed when upgrade job is resumed", "The component's upgrade is successfully completed", "The component's upgrade has failed. This will move to resume if upgrade is resumed or stay as is", "Component's upgrade has not started yet", "Component's upgrade is not applicable in this upgrade. It will be skipped." ] } }, "type": "object", "id": "VmwareUpgradeComponent", "description": "Per component upgrade resource" }, "LocationMetadata": { "id": "LocationMetadata", "type": "object", "description": "VmwareEngine specific metadata for the given google.cloud.location.Location. It is returned as a content of the `google.cloud.location.Location.metadata` field.", "properties": { "capabilities": { "type": "array", "description": "Output only. Capabilities of this location.", "readOnly": true, "items": { "type": "string", "enum": [ "CAPABILITY_UNSPECIFIED", "STRETCHED_CLUSTERS" ], "enumDescriptions": [ "The default value. This value is used if the capability is omitted or unknown.", "Stretch clusters are supported in this location." ] } } } }, "RevokeDnsBindPermissionRequest": { "description": "Request message for VmwareEngine.RevokeDnsBindPermission", "type": "object", "id": "RevokeDnsBindPermissionRequest", "properties": { "principal": { "$ref": "Principal", "description": "Required. The consumer provided user/service account which needs to be granted permission to bind with the intranet VPC corresponding to the consumer project." }, "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" } } }, "AutoscalingPolicy": { "type": "object", "description": "Autoscaling policy describes the behavior of the autoscaling with respect to the resource utilization. The scale-out operation is initiated if the utilization exceeds ANY of the respective thresholds. The scale-in operation is initiated if the utilization is below ALL of the respective thresholds.", "properties": { "cpuThresholds": { "description": "Optional. Utilization thresholds pertaining to CPU utilization.", "$ref": "Thresholds" }, "nodeTypeId": { "description": "Required. The canonical identifier of the node type to add or remove. Corresponds to the `NodeType`.", "type": "string" }, "scaleOutSize": { "type": "integer", "description": "Required. Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters. During a scale-in operation only one node (or 2 for stretched clusters) are removed in a single iteration.", "format": "int32" }, "storageThresholds": { "description": "Optional. Utilization thresholds pertaining to amount of consumed storage.", "$ref": "Thresholds" }, "grantedMemoryThresholds": { "$ref": "Thresholds", "description": "Optional. Utilization thresholds pertaining to amount of granted memory." }, "consumedMemoryThresholds": { "$ref": "Thresholds", "description": "Optional. Utilization thresholds pertaining to amount of consumed memory." } }, "id": "AutoscalingPolicy" }, "StretchedClusterConfig": { "properties": { "secondaryLocation": { "type": "string", "description": "Required. Additional zone for a higher level of availability and load balancing. Specify the resource name of a zone that belongs to the region of the private cloud. For example: `projects/{project}/locations/europe-west3-b` where `{project}` can either be a project number or a project ID." }, "preferredLocation": { "type": "string", "description": "Required. Zone that will remain operational when connection between the two zones is lost. Specify the resource name of a zone that belongs to the region of the private cloud. For example: `projects/{project}/locations/europe-west3-a` where `{project}` can either be a project number or a project ID." } }, "type": "object", "description": "Configuration of a stretched cluster.", "id": "StretchedClusterConfig" }, "Constraints": { "description": "Constraints to be applied while editing a schedule. These constraints ensure that `Upgrade` specific requirements are met.", "type": "object", "properties": { "disallowedIntervals": { "description": "Output only. Output Only. A list of intervals in which maintenance windows are not allowed. Any time window that overlaps with any of these intervals will be considered invalid.", "type": "array", "readOnly": true, "items": { "$ref": "WeeklyTimeInterval" } }, "minHoursWeek": { "description": "Output only. The minimum number of weekly hours must be allotted for the upgrade activities. This is just a minimum; the schedule can assign more weekly hours.", "readOnly": true, "format": "int32", "type": "integer" }, "rescheduleDateRange": { "readOnly": true, "$ref": "Interval", "description": "Output only. Output Only. The user can only reschedule an upgrade that starts within this range." }, "minHoursDay": { "type": "integer", "readOnly": true, "description": "Output only. Minimum number of hours must be allotted for the upgrade activities for each selected day. This is a minimum; the upgrade schedule can allot more hours for the given day.", "format": "int32" } }, "id": "Constraints" }, "DnsForwarding": { "id": "DnsForwarding", "description": "DNS forwarding config. This config defines a list of domain to name server mappings, and is attached to the private cloud for custom domain resolution.", "type": "object", "properties": { "forwardingRules": { "items": { "$ref": "ForwardingRule" }, "type": "array", "description": "Required. List of domain mappings to configure" }, "updateTime": { "type": "string", "format": "google-datetime", "description": "Output only. Last update time of this resource.", "readOnly": true }, "createTime": { "type": "string", "description": "Output only. Creation time of this resource.", "readOnly": true, "format": "google-datetime" }, "name": { "type": "string", "description": "Output only. Identifier. The resource name of this DNS profile. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/dnsForwarding`", "readOnly": true } } }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "type": "object", "properties": { "policy": { "$ref": "Policy", "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." }, "updateMask": { "type": "string", "format": "google-fieldmask", "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: \"bindings, etag\"`" } }, "id": "SetIamPolicyRequest" }, "DatastoreNetwork": { "id": "DatastoreNetwork", "type": "object", "description": "The network configuration for the datastore.", "properties": { "subnet": { "type": "string", "description": "Required. The resource name of the subnet Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. e.g. projects/my-project/locations/us-central1/subnets/my-subnet" }, "mtu": { "format": "int32", "description": "Optional. MTU value is set on the VMKernel adapter for the NFS traffic. By default standard 1500 MTU size is set in MountDatastore API which is good for typical setups. However google VPC networks supports jumbo MTU 8896. We recommend to tune this value based on the NFS traffic performance. Performance can be determined using benchmarking I/O tools like fio (Flexible I/O Tester) utility.", "type": "integer" }, "networkPeering": { "readOnly": true, "description": "Output only. The resource name of the network peering, used to access the file share by clients on private cloud. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. e.g. projects/my-project/locations/us-central1/networkPeerings/my-network-peering", "type": "string" }, "connectionCount": { "type": "integer", "format": "int32", "description": "Optional. connection_count is used to set multiple connections from NFS client on ESXi host to NFS server. A higher number of connections results in better performance on datastores. In MountDatastore API by default max 4 connections are configured. User can set value of connection_count between 1 to 4. Connection_count is supported from vsphere 8.0u1 for earlier version 1 connection count is set on the ESXi hosts." } } }, "ListPrivateConnectionsResponse": { "type": "object", "description": "Response message for VmwareEngine.ListPrivateConnections", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "privateConnections": { "description": "A list of private connections.", "items": { "$ref": "PrivateConnection" }, "type": "array" }, "unreachable": { "items": { "type": "string" }, "description": "Unreachable resources.", "type": "array" } }, "id": "ListPrivateConnectionsResponse" }, "Cluster": { "properties": { "createTime": { "type": "string", "readOnly": true, "description": "Output only. Creation time of this resource.", "format": "google-datetime" }, "management": { "type": "boolean", "readOnly": true, "description": "Output only. True if the cluster is a management cluster; false otherwise. There can only be one management cluster in a private cloud and it has to be the first one." }, "autoscalingSettings": { "description": "Optional. Configuration of the autoscaling applied to this cluster.", "$ref": "AutoscalingSettings" }, "datastoreMountConfig": { "items": { "$ref": "DatastoreMountConfig" }, "description": "Output only. Configuration of a mounted datastore.", "readOnly": true, "type": "array" }, "nodeTypeConfigs": { "type": "object", "additionalProperties": { "$ref": "NodeTypeConfig" }, "description": "Required. The map of cluster node types in this cluster, where the key is canonical identifier of the node type (corresponds to the `NodeType`)." }, "uid": { "readOnly": true, "type": "string", "description": "Output only. System-generated unique identifier for the resource." }, "name": { "readOnly": true, "description": "Output only. Identifier. The resource name of this cluster. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster`", "type": "string" }, "stretchedClusterConfig": { "$ref": "StretchedClusterConfig", "description": "Optional. Configuration of a stretched cluster. Required for clusters that belong to a STRETCHED private cloud." }, "state": { "description": "Output only. State of the resource.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "UPDATING", "DELETING", "REPAIRING" ], "enumDescriptions": [ "The default value. This value should never be used.", "The Cluster is operational and can be used by the user.", "The Cluster is being deployed.", "Adding or removing of a node to the cluster, any other cluster specific updates.", "The Cluster is being deleted.", "The Cluster is undergoing maintenance, for example: a failed node is getting replaced." ], "readOnly": true }, "updateTime": { "readOnly": true, "description": "Output only. Last update time of this resource.", "type": "string", "format": "google-datetime" } }, "id": "Cluster", "type": "object", "description": "A cluster in a private cloud." }, "Empty": { "id": "Empty", "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); }", "type": "object", "properties": {} }, "Location": { "type": "object", "id": "Location", "description": "A resource that represents a Google Cloud location.", "properties": { "metadata": { "description": "Service-specific metadata. For example the available capacity at the given location.", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "labels": { "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "additionalProperties": { "type": "string" }, "type": "object" }, "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "name": { "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" }, "locationId": { "description": "The canonical id for this location. For example: `\"us-east1\"`.", "type": "string" } } }, "ListOperationsResponse": { "type": "object", "description": "The response message for Operations.ListOperations.", "properties": { "nextPageToken": { "type": "string", "description": "The standard List next-page token." }, "unreachable": { "items": { "type": "string" }, "type": "array", "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations." }, "operations": { "description": "A list of operations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Operation" } } }, "id": "ListOperationsResponse" }, "RepairManagementDnsZoneBindingRequest": { "id": "RepairManagementDnsZoneBindingRequest", "description": "Request message for VmwareEngine.RepairManagementDnsZoneBindings", "type": "object", "properties": { "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" } } }, "ListNetworkPoliciesResponse": { "properties": { "networkPolicies": { "type": "array", "items": { "$ref": "NetworkPolicy" }, "description": "A list of network policies." }, "nextPageToken": { "type": "string", "description": "A token, which can be send as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations that could not be reached when making an aggregated query using wildcards." } }, "id": "ListNetworkPoliciesResponse", "type": "object", "description": "Response message for VmwareEngine.ListNetworkPolicies" }, "DatastoreMountConfig": { "id": "DatastoreMountConfig", "properties": { "datastoreNetwork": { "$ref": "DatastoreNetwork", "description": "Required. The network configuration for the datastore." }, "datastore": { "type": "string", "description": "Required. The resource name of the datastore to mount. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/datastores/my-datastore`" }, "servers": { "items": { "type": "string" }, "readOnly": true, "type": "array", "description": "Output only. Server IP addresses of the NFS volume. For NFS 3, you can only provide a single server IP address or DNS names." }, "nfsVersion": { "enumDescriptions": [ "The default value. This value should never be used.", "NFS 3" ], "type": "string", "enum": [ "NFS_VERSION_UNSPECIFIED", "NFS_V3" ], "description": "Optional. The NFS protocol supported by the NFS volume. Default value used will be NFS_V3" }, "accessMode": { "description": "Optional. The access mode of the NFS volume. Optional. Default value used will be READ_WRITE", "enumDescriptions": [ "The default value. This value should never be used.", "NFS is accessed by hosts in read mode", "NFS is accessed by hosts in read and write mode" ], "type": "string", "enum": [ "ACCESS_MODE_UNSPECIFIED", "READ_ONLY", "READ_WRITE" ] }, "fileShare": { "type": "string", "readOnly": true, "description": "Output only. File share name." } }, "type": "object", "description": "The Datastore Mount configuration" }, "WeeklyTimeInterval": { "description": "Represents a time interval, spanning across days of the week. Until local timezones are supported, this interval is in UTC.", "type": "object", "id": "WeeklyTimeInterval", "properties": { "startDay": { "type": "string", "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "description": "Output only. The day on which the interval starts.", "readOnly": true, "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ] }, "startTime": { "readOnly": true, "description": "Output only. The time on the start day at which the interval starts.", "$ref": "TimeOfDay" }, "endTime": { "readOnly": true, "description": "Output only. The time on the end day at which the interval ends.", "$ref": "TimeOfDay" }, "endDay": { "description": "Output only. The day on which the interval ends. Can be same as start day.", "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "type": "string", "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "readOnly": true } } }, "PrivateCloud": { "type": "object", "properties": { "nsx": { "$ref": "Nsx", "readOnly": true, "description": "Output only. NSX appliance." }, "updateTime": { "type": "string", "description": "Output only. Last update time of this resource.", "format": "google-datetime", "readOnly": true }, "networkConfig": { "description": "Required. Network configuration of the private cloud.", "$ref": "NetworkConfig" }, "uid": { "description": "Output only. System-generated unique identifier for the resource.", "readOnly": true, "type": "string" }, "hcx": { "readOnly": true, "$ref": "Hcx", "description": "Output only. HCX appliance." }, "createTime": { "format": "google-datetime", "type": "string", "description": "Output only. Creation time of this resource.", "readOnly": true }, "expireTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Time when the resource will be irreversibly deleted." }, "name": { "description": "Output only. Identifier. The resource name of this private cloud. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud`", "type": "string", "readOnly": true }, "managementCluster": { "description": "Required. Input only. The management cluster for this private cloud. This field is required during creation of the private cloud to provide details for the default cluster. The following fields can't be changed after private cloud creation: `ManagementCluster.clusterId`, `ManagementCluster.nodeTypeId`.", "$ref": "ManagementCluster" }, "vcenter": { "description": "Output only. Vcenter appliance.", "$ref": "Vcenter", "readOnly": true }, "deleteTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time when the resource was scheduled for deletion." }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "UPDATING", "FAILED", "DELETED", "PURGING" ], "readOnly": true, "enumDescriptions": [ "The default value. This value should never be used.", "The private cloud is ready.", "The private cloud is being created.", "The private cloud is being updated.", "The private cloud is in failed state.", "The private cloud is scheduled for deletion. The deletion process can be cancelled by using the corresponding undelete method.", "The private cloud is irreversibly deleted and is being removed from the system." ], "description": "Output only. State of the resource. New values may be added to this enum when appropriate." }, "encryptionConfig": { "description": "Optional. Encryption configuration for the private cloud. If this field is left unspecified, Google default encryption is used.", "$ref": "EncryptionConfig" }, "description": { "description": "User-provided description for this private cloud.", "type": "string" }, "type": { "type": "string", "enum": [ "STANDARD", "TIME_LIMITED", "STRETCHED" ], "enumDescriptions": [ "Standard private is a zonal resource, with 3+ nodes. Default type.", "Time limited private cloud is a zonal resource, can have only 1 node and has limited life span. Will be deleted after defined period of time, can be converted into standard private cloud by expanding it up to 3 or more nodes.", "Stretched private cloud is a regional resource with redundancy, with a minimum of 6 nodes, nodes count has to be even." ], "description": "Optional. Type of the private cloud. Defaults to STANDARD." } }, "description": "Represents a private cloud resource. Private clouds of type `STANDARD` and `TIME_LIMITED` are zonal resources, `STRETCHED` private clouds are regional.", "id": "PrivateCloud" }, "Schedule": { "description": "Schedule for the upgrade.", "properties": { "editWindow": { "readOnly": true, "description": "Output only. Output Only. The schedule is open for edits during this time interval or window.", "$ref": "Interval" }, "lastEditor": { "type": "string", "enum": [ "EDITOR_UNSPECIFIED", "SYSTEM", "USER" ], "readOnly": true, "description": "Output only. Output Only. Indicates who most recently edited the upgrade schedule. The value is updated whenever the upgrade is rescheduled.", "enumDescriptions": [ "The default value. This value should never be used.", "The upgrade is scheduled by the System or internal service.", "The upgrade is scheduled by the end user." ] }, "startTime": { "format": "google-datetime", "type": "string", "description": "Required. The scheduled start time for the upgrade." }, "constraints": { "readOnly": true, "$ref": "Constraints", "description": "Output only. Output Only. Constraints applied to the schedule. These constraints should be applicable at the time of any rescheduling." }, "weeklyWindows": { "description": "Required. Weekly time windows for upgrade activities. The server performs upgrade activities during these time windows to minimize disruptions.", "type": "array", "items": { "$ref": "TimeWindow" } } }, "type": "object", "id": "Schedule" }, "ListUpgradesResponse": { "description": "Response message for VmwareEngine.ListUpgrades.", "type": "object", "id": "ListUpgradesResponse", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "upgrades": { "description": "A list of `Upgrades`.", "items": { "$ref": "Upgrade" }, "type": "array" }, "unreachable": { "type": "array", "description": "List of unreachable resources.", "items": { "type": "string" } } } }, "Policy": { "properties": { "bindings": { "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", "items": { "$ref": "Binding" }, "type": "array" }, "etag": { "format": "byte", "type": "string", "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost." }, "version": { "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "type": "integer" }, "auditConfigs": { "type": "array", "description": "Specifies cloud audit logging configuration for this policy.", "items": { "$ref": "AuditConfig" } } }, "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "type": "object", "id": "Policy" }, "MigrateManagementVmsRequest": { "properties": { "etag": { "type": "string", "description": "Optional. Checksum used to ensure that the user-provided value is up to date before the server processes the request. The server compares provided checksum with the current checksum of the resource. If the user-provided value is out of date, this request returns an `ABORTED` error." }, "clusterId": { "description": "Required. The user-provided identifier of the workload cluster to which the management VMs are to be migrated. The cluster must be in the same private cloud as the one specified in `name`, and must be a workload cluster. The eventual cluster name will be constructed from the private cloud name and this cluster ID.", "type": "string" }, "requestId": { "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if the original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "description": "Request message for VmwareEngine.MigrateManagementVms", "id": "MigrateManagementVmsRequest", "type": "object" }, "NfsDatastore": { "description": "The NFS datastore configuration.", "type": "object", "properties": { "thirdPartyFileService": { "$ref": "ThirdPartyFileService", "description": "Third party file service configuration" }, "googleFileService": { "description": "Google file service configuration", "$ref": "GoogleFileService" }, "googleVmwareFileService": { "$ref": "GoogleVmwareFileService", "description": "GCVE file service configuration" } }, "id": "NfsDatastore" }, "NodeTypeConfig": { "properties": { "customCoreCount": { "format": "int32", "description": "Optional. Customized number of cores available to each node of the type. This number must always be one of `nodeType.availableCustomCoreCounts`. If zero is provided max value from `nodeType.availableCustomCoreCounts` will be used.", "type": "integer" }, "nodeCount": { "description": "Required. The number of nodes of this type in the cluster", "type": "integer", "format": "int32" } }, "type": "object", "id": "NodeTypeConfig", "description": "Information about the type and number of nodes associated with the cluster." }, "Hcx": { "id": "Hcx", "type": "object", "description": "Details about a HCX Cloud Manager appliance.", "properties": { "fqdn": { "type": "string", "description": "Fully qualified domain name of the appliance." }, "version": { "type": "string", "description": "Version of the appliance." }, "internalIp": { "type": "string", "description": "Internal IP address of the appliance." }, "state": { "enumDescriptions": [ "Unspecified appliance state. This is the default value.", "The appliance is operational and can be used.", "The appliance is being deployed.", "The appliance is being activated." ], "readOnly": true, "description": "Output only. The state of the appliance.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "ACTIVATING" ] } } }, "MountDatastoreRequest": { "type": "object", "description": "Mount Datastore Request message", "properties": { "validateOnly": { "type": "boolean", "description": "Optional. If set to `true`, only validates the request but doesn’t execute the request. If set to `false`, validates and executes the request." }, "ignoreColocation": { "description": "Optional. If set to true, the colocation requirement will be ignored. If set to false, the colocation requirement will be enforced. If not set, the colocation requirement will be enforced. Colocation requirement is the requirement that the cluster must be in the same region/zone of datastore(regional/zonal datastore).", "type": "boolean" }, "requestId": { "type": "string", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "datastoreMountConfig": { "description": "Required. The datastore mount configuration.", "$ref": "DatastoreMountConfig" } }, "id": "MountDatastoreRequest" }, "ListAnnouncementsResponse": { "type": "object", "properties": { "unreachable": { "type": "array", "description": "list of unreachable locations", "items": { "type": "string" } }, "announcements": { "description": "A list of announcement runs.", "items": { "$ref": "Announcement" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "description": "Response message for VmwareEngine.ListAnnouncements", "id": "ListAnnouncementsResponse" }, "ListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "properties": { "locations": { "items": { "$ref": "Location" }, "type": "array", "description": "A list of locations that matches the specified filter in the request." }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." } }, "id": "ListLocationsResponse", "type": "object" }, "ListClustersResponse": { "type": "object", "id": "ListClustersResponse", "description": "Response message for VmwareEngine.ListClusters", "properties": { "clusters": { "items": { "$ref": "Cluster" }, "description": "A list of private cloud clusters.", "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached when making an aggregated query using wildcards.", "type": "array", "items": { "type": "string" } } } }, "ResetNsxCredentialsRequest": { "properties": { "requestId": { "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" } }, "id": "ResetNsxCredentialsRequest", "description": "Request message for VmwareEngine.ResetNsxCredentials", "type": "object" }, "TestIamPermissionsRequest": { "type": "object", "id": "TestIamPermissionsRequest", "properties": { "permissions": { "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, "type": "array" } }, "description": "Request message for `TestIamPermissions` method." }, "GrantDnsBindPermissionRequest": { "type": "object", "properties": { "principal": { "$ref": "Principal", "description": "Required. The consumer provided user/service account which needs to be granted permission to bind with the intranet VPC corresponding to the consumer project." }, "requestId": { "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." } }, "id": "GrantDnsBindPermissionRequest", "description": "Request message for VmwareEngine.GrantDnsBindPermission" }, "AcceleratePrivateCloudDeletionRequest": { "type": "object", "id": "AcceleratePrivateCloudDeletionRequest", "description": "Request message for VmwareEngine.AcceleratePrivateCloudDeletion", "properties": { "requestId": { "type": "string", "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "etag": { "type": "string", "description": "Optional. Checksum used to ensure that the user-provided value is up to date before the server processes the request. The server compares provided checksum with the current checksum of the resource. If the user-provided value is out of date, this request returns an `ABORTED` error." } } }, "LoggingServer": { "type": "object", "properties": { "updateTime": { "description": "Output only. Last update time of this resource.", "readOnly": true, "type": "string", "format": "google-datetime" }, "name": { "description": "Output only. The resource name of this logging server. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/loggingServers/my-logging-server`", "readOnly": true, "type": "string" }, "uid": { "type": "string", "readOnly": true, "description": "Output only. System-generated unique identifier for the resource." }, "hostname": { "description": "Required. Fully-qualified domain name (FQDN) or IP Address of the logging server.", "type": "string" }, "port": { "format": "int32", "type": "integer", "description": "Required. Port number at which the logging server receives logs." }, "protocol": { "enumDescriptions": [ "Unspecified communications protocol. This is the default value.", "UDP", "TCP", "TLS", "SSL", "RELP" ], "type": "string", "enum": [ "PROTOCOL_UNSPECIFIED", "UDP", "TCP", "TLS", "SSL", "RELP" ], "description": "Required. Protocol used by vCenter to send logs to a logging server." }, "createTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Creation time of this resource." }, "sourceType": { "enumDescriptions": [ "The default value. This value should never be used.", "Logs produced by ESXI hosts", "Logs produced by vCenter server" ], "description": "Required. The type of component that produces logs that will be forwarded to this logging server.", "type": "string", "enum": [ "SOURCE_TYPE_UNSPECIFIED", "ESXI", "VCSA" ] } }, "description": "Logging server to receive vCenter or ESXi logs.", "id": "LoggingServer" }, "ResetVcenterCredentialsRequest": { "properties": { "requestId": { "type": "string", "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000)." }, "username": { "description": "Optional. The username of the user to be to reset the credentials. The default value of this field is CloudOwner@gve.local. The provided value should be one of the following: solution-user-01@gve.local, solution-user-02@gve.local, solution-user-03@gve.local, solution-user-04@gve.local, solution-user-05@gve.local, zertoadmin@gve.local.", "type": "string" } }, "description": "Request message for VmwareEngine.ResetVcenterCredentials", "id": "ResetVcenterCredentialsRequest", "type": "object" }, "GoogleVmwareFileService": { "id": "GoogleVmwareFileService", "description": "Volume message captures user inputs for creation of file services managed by GCVE", "properties": {}, "type": "object" }, "AuditLogConfig": { "id": "AuditLogConfig", "properties": { "exemptedMembers": { "items": { "type": "string" }, "type": "array", "description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members." }, "logType": { "type": "string", "enum": [ "LOG_TYPE_UNSPECIFIED", "ADMIN_READ", "DATA_WRITE", "DATA_READ" ], "enumDescriptions": [ "Default case. Should never be this.", "Admin reads. Example: CloudIAM getIamPolicy", "Data writes. Example: CloudSQL Users create", "Data reads. Example: CloudSQL Users list" ], "description": "The log type that this config enables." } }, "description": "Provides the configuration for logging a type of permissions. Example: { \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.", "type": "object" }, "PeeringRoute": { "description": "Exchanged network peering route.", "id": "PeeringRoute", "properties": { "destRange": { "type": "string", "description": "Output only. Destination range of the peering route in CIDR notation.", "readOnly": true }, "nextHopRegion": { "readOnly": true, "type": "string", "description": "Output only. Region containing the next hop of the peering route. This field only applies to dynamic routes in the peer VPC network." }, "priority": { "format": "int64", "description": "Output only. The priority of the peering route.", "type": "string", "readOnly": true }, "type": { "enumDescriptions": [ "Unspecified peering route type. This is the default value.", "Dynamic routes in the peer network.", "Static routes in the peer network.", "Created, updated, and removed automatically by Google Cloud when subnets are created, modified, or deleted in the peer network." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "DYNAMIC_PEERING_ROUTE", "STATIC_PEERING_ROUTE", "SUBNET_PEERING_ROUTE" ], "readOnly": true, "description": "Output only. Type of the route in the peer VPC network." }, "direction": { "description": "Output only. Direction of the routes exchanged with the peer network, from the VMware Engine network perspective: * Routes of direction `INCOMING` are imported from the peer network. * Routes of direction `OUTGOING` are exported from the intranet VPC network of the VMware Engine network.", "enumDescriptions": [ "Unspecified exchanged routes direction. This is default.", "Routes imported from the peer network.", "Routes exported to the peer network." ], "readOnly": true, "type": "string", "enum": [ "DIRECTION_UNSPECIFIED", "INCOMING", "OUTGOING" ] }, "imported": { "description": "Output only. True if the peering route has been imported from a peered VPC network; false otherwise. The import happens if the field `NetworkPeering.importCustomRoutes` is true for this network, `NetworkPeering.exportCustomRoutes` is true for the peer VPC network, and the import does not result in a route conflict.", "readOnly": true, "type": "boolean" } }, "type": "object" }, "Binding": { "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", "type": "object", "properties": { "condition": { "$ref": "Expr", "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "role": { "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).", "type": "string" }, "members": { "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "items": { "type": "string" }, "type": "array" } } }, "Thresholds": { "type": "object", "description": "Thresholds define the utilization of resources triggering scale-out and scale-in operations.", "id": "Thresholds", "properties": { "scaleIn": { "type": "integer", "format": "int32", "description": "Required. The utilization triggering the scale-in operation in percent." }, "scaleOut": { "description": "Required. The utilization triggering the scale-out operation in percent.", "type": "integer", "format": "int32" } } }, "ListPeeringRoutesResponse": { "id": "ListPeeringRoutesResponse", "description": "Response message for VmwareEngine.ListPeeringRoutes", "type": "object", "properties": { "peeringRoutes": { "type": "array", "items": { "$ref": "PeeringRoute" }, "description": "A list of peering routes." }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "ListVmwareEngineNetworksResponse": { "description": "Response message for VmwareEngine.ListVmwareEngineNetworks", "type": "object", "id": "ListVmwareEngineNetworksResponse", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "vmwareEngineNetworks": { "type": "array", "description": "A list of VMware Engine networks.", "items": { "$ref": "VmwareEngineNetwork" } }, "unreachable": { "description": "Unreachable resources.", "items": { "type": "string" }, "type": "array" } } }, "NetworkPolicy": { "description": "Represents a network policy resource. Network policies are regional resources. You can use a network policy to enable or disable internet access and external IP access. Network policies are associated with a VMware Engine network, which might span across regions. For a given region, a network policy applies to all private clouds in the VMware Engine network associated with the policy.", "properties": { "vmwareEngineNetworkCanonical": { "description": "Output only. The canonical name of the VMware Engine network in the form: `projects/{project_number}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}`", "readOnly": true, "type": "string" }, "name": { "description": "Output only. Identifier. The resource name of this network policy. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/networkPolicies/my-network-policy`", "type": "string", "readOnly": true }, "uid": { "readOnly": true, "description": "Output only. System-generated unique identifier for the resource.", "type": "string" }, "createTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Creation time of this resource." }, "vmwareEngineNetwork": { "description": "Optional. The relative resource name of the VMware Engine network. Specify the name in the following form: `projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}` where `{project}` can either be a project number or a project ID.", "type": "string" }, "updateTime": { "description": "Output only. Last update time of this resource.", "type": "string", "format": "google-datetime", "readOnly": true }, "internetAccess": { "$ref": "NetworkService", "description": "Network service that allows VMware workloads to access the internet." }, "description": { "type": "string", "description": "Optional. User-provided description for this network policy." }, "edgeServicesCidr": { "description": "Required. IP address range in CIDR notation used to create internet access and external IP access. An RFC 1918 CIDR block, with a \"/26\" prefix, is required. The range cannot overlap with any prefixes either in the consumer VPC network or in use by the private clouds attached to that VPC network.", "type": "string" }, "externalIp": { "$ref": "NetworkService", "description": "Network service that allows External IP addresses to be assigned to VMware workloads. This service can only be enabled when `internet_access` is also enabled." } }, "id": "NetworkPolicy", "type": "object" }, "GoogleFileService": { "description": "Google service file service configuration", "properties": { "netappVolume": { "description": "Google netapp volume resource name e.g. projects/my-project/locations/me-west1-b/volumes/my-volume", "type": "string" }, "filestoreInstance": { "description": "Google filestore instance resource name e.g. projects/my-project/locations/me-west1-b/instances/my-instance", "type": "string" } }, "id": "GoogleFileService", "type": "object" }, "NetworkService": { "id": "NetworkService", "properties": { "enabled": { "description": "True if the service is enabled; false otherwise.", "type": "boolean" }, "state": { "readOnly": true, "enumDescriptions": [ "Unspecified service state. This is the default value.", "Service is not provisioned.", "Service is in the process of being provisioned/deprovisioned.", "Service is active." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "UNPROVISIONED", "RECONCILING", "ACTIVE" ], "description": "Output only. State of the service. New values may be added to this enum when appropriate." } }, "description": "Represents a network service that is managed by a `NetworkPolicy` resource. A network service provides a way to control an aspect of external access to VMware workloads. For example, whether the VMware workloads in the private clouds governed by a network policy can access or be accessed from the internet.", "type": "object" }, "Operation": { "type": "object", "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "metadata": { "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.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object" }, "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}`." }, "error": { "$ref": "Status", "description": "The error result of the operation in case of failure or cancellation." }, "response": { "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "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`." }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." } }, "id": "Operation" }, "ListNetworkPeeringsResponse": { "id": "ListNetworkPeeringsResponse", "type": "object", "description": "Response message for VmwareEngine.ListNetworkPeerings", "properties": { "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Unreachable resources." }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "networkPeerings": { "description": "A list of network peerings.", "type": "array", "items": { "$ref": "NetworkPeering" } } } }, "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": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "type": "array", "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } }, "code": { "type": "integer", "format": "int32", "description": "The status code, which should be an enum value of google.rpc.Code." } } }, "Vcenter": { "type": "object", "properties": { "state": { "enumDescriptions": [ "Unspecified appliance state. This is the default value.", "The appliance is operational and can be used.", "The appliance is being deployed." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING" ], "readOnly": true, "description": "Output only. The state of the appliance." }, "fqdn": { "description": "Fully qualified domain name of the appliance.", "type": "string" }, "version": { "description": "Version of the appliance.", "type": "string" }, "internalIp": { "type": "string", "description": "Internal IP address of the appliance." } }, "description": "Details about a vCenter Server management appliance.", "id": "Vcenter" }, "ExternalAddress": { "type": "object", "description": "Represents an allocated external IP address and its corresponding internal IP address in a private cloud.", "properties": { "externalIp": { "description": "Output only. The external IP address of a workload VM.", "readOnly": true, "type": "string" }, "state": { "enumDescriptions": [ "The default value. This value should never be used.", "The address is ready.", "The address is being created.", "The address is being updated.", "The address is being deleted." ], "description": "Output only. The state of the resource.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "UPDATING", "DELETING" ], "readOnly": true }, "internalIp": { "description": "The internal IP address of a workload VM.", "type": "string" }, "createTime": { "description": "Output only. Creation time of this resource.", "format": "google-datetime", "type": "string", "readOnly": true }, "name": { "type": "string", "readOnly": true, "description": "Output only. Identifier. The resource name of this external IP address. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address`" }, "description": { "description": "User-provided description for this resource.", "type": "string" }, "updateTime": { "readOnly": true, "type": "string", "description": "Output only. Last update time of this resource.", "format": "google-datetime" }, "uid": { "readOnly": true, "description": "Output only. System-generated unique identifier for the resource.", "type": "string" } }, "id": "ExternalAddress" }, "ForwardingRule": { "description": "A forwarding rule is a mapping of a `domain` to `name_servers`. This mapping allows VMware Engine to resolve domains for attached private clouds by forwarding DNS requests for a given domain to the specified nameservers.", "type": "object", "properties": { "domain": { "type": "string", "description": "Required. Domain used to resolve a `name_servers` list." }, "nameServers": { "items": { "type": "string" }, "description": "Required. List of DNS servers to use for domain resolution", "type": "array" } }, "id": "ForwardingRule" }, "PrivateConnection": { "type": "object", "id": "PrivateConnection", "description": "Private connection resource that provides connectivity for VMware Engine private clouds.", "properties": { "uid": { "description": "Output only. System-generated unique identifier for the resource.", "type": "string", "readOnly": true }, "createTime": { "description": "Output only. Creation time of this resource.", "format": "google-datetime", "type": "string", "readOnly": true }, "vmwareEngineNetwork": { "type": "string", "description": "Required. The relative resource name of Legacy VMware Engine network. Specify the name in the following form: `projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}` where `{project}`, `{location}` will be same as specified in private connection resource name and `{vmware_engine_network_id}` will be in the form of `{location}`-default e.g. projects/project/locations/us-central1/vmwareEngineNetworks/us-central1-default." }, "routingMode": { "enumDescriptions": [ "The default value. This value should never be used.", "Global Routing Mode", "Regional Routing Mode" ], "type": "string", "enum": [ "ROUTING_MODE_UNSPECIFIED", "GLOBAL", "REGIONAL" ], "description": "Optional. Routing Mode. Default value is set to GLOBAL. For type = PRIVATE_SERVICE_ACCESS, this field can be set to GLOBAL or REGIONAL, for other types only GLOBAL is supported." }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "UPDATING", "DELETING", "UNPROVISIONED", "FAILED" ], "enumDescriptions": [ "The default value. This value is used if the state is omitted.", "The private connection is being created.", "The private connection is ready.", "The private connection is being updated.", "The private connection is being deleted.", "The private connection is not provisioned, since no private cloud is present for which this private connection is needed.", "The private connection is in failed state." ], "readOnly": true, "description": "Output only. State of the private connection." }, "updateTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Last update time of this resource." }, "peeringId": { "readOnly": true, "type": "string", "description": "Output only. VPC network peering id between given network VPC and VMwareEngineNetwork." }, "peeringState": { "enumDescriptions": [ "The default value. This value is used if the peering state is omitted or unknown.", "The peering is in active state.", "The peering is in inactive state." ], "readOnly": true, "type": "string", "enum": [ "PEERING_STATE_UNSPECIFIED", "PEERING_ACTIVE", "PEERING_INACTIVE" ], "description": "Output only. Peering state between service network and VMware Engine network." }, "type": { "description": "Required. Private connection type.", "type": "string", "enum": [ "TYPE_UNSPECIFIED", "PRIVATE_SERVICE_ACCESS", "NETAPP_CLOUD_VOLUMES", "DELL_POWERSCALE", "THIRD_PARTY_SERVICE" ], "enumDescriptions": [ "The default value. This value should never be used.", "Connection used for establishing [private services access](https://cloud.google.com/vpc/docs/private-services-access).", "Connection used for connecting to NetApp Cloud Volumes.", "Connection used for connecting to Dell PowerScale.", "Connection used for connecting to third-party services." ] }, "vmwareEngineNetworkCanonical": { "readOnly": true, "description": "Output only. The canonical name of the VMware Engine network in the form: `projects/{project_number}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}`", "type": "string" }, "description": { "description": "Optional. User-provided description for this private connection.", "type": "string" }, "serviceNetwork": { "description": "Required. Service network to create private connection. Specify the name in the following form: `projects/{project}/global/networks/{network_id}` For type = PRIVATE_SERVICE_ACCESS, this field represents servicenetworking VPC, e.g. projects/project-tp/global/networks/servicenetworking. For type = NETAPP_CLOUD_VOLUME, this field represents NetApp service VPC, e.g. projects/project-tp/global/networks/netapp-tenant-vpc. For type = DELL_POWERSCALE, this field represent Dell service VPC, e.g. projects/project-tp/global/networks/dell-tenant-vpc. For type= THIRD_PARTY_SERVICE, this field could represent a consumer VPC or any other producer VPC to which the VMware Engine Network needs to be connected, e.g. projects/project/global/networks/vpc.", "type": "string" }, "name": { "type": "string", "description": "Output only. The resource name of the private connection. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/us-central1/privateConnections/my-connection`", "readOnly": true } } }, "VmwareEngineNetwork": { "id": "VmwareEngineNetwork", "type": "object", "properties": { "name": { "type": "string", "readOnly": true, "description": "Output only. Identifier. The resource name of the VMware Engine network. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/vmwareEngineNetworks/my-network`" }, "etag": { "description": "Checksum that may be sent on update and delete requests to ensure that the user-provided value is up to date before the server processes a request. The server computes checksums based on the value of other fields in the request.", "type": "string" }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "UPDATING", "DELETING" ], "enumDescriptions": [ "The default value. This value is used if the state is omitted.", "The VMware Engine network is being created.", "The VMware Engine network is ready.", "The VMware Engine network is being updated.", "The VMware Engine network is being deleted." ], "readOnly": true, "description": "Output only. State of the VMware Engine network." }, "updateTime": { "description": "Output only. Last update time of this resource.", "format": "google-datetime", "readOnly": true, "type": "string" }, "vpcNetworks": { "readOnly": true, "description": "Output only. VMware Engine service VPC networks that provide connectivity from a private cloud to customer projects, the internet, and other Google Cloud services.", "items": { "$ref": "VpcNetwork" }, "type": "array" }, "uid": { "description": "Output only. System-generated unique identifier for the resource.", "readOnly": true, "type": "string" }, "description": { "type": "string", "description": "User-provided description for this VMware Engine network." }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Creation time of this resource.", "type": "string" }, "type": { "type": "string", "enum": [ "TYPE_UNSPECIFIED", "LEGACY", "STANDARD" ], "description": "Required. VMware Engine network type.", "enumDescriptions": [ "The default value. This value should never be used.", "Network type used by private clouds created in projects without a network of type `STANDARD`. This network type is no longer used for new VMware Engine private cloud deployments.", "Standard network type used for private cloud connectivity." ] } }, "description": "VMware Engine network resource that provides connectivity for VMware Engine private clouds." }, "ListExternalAccessRulesResponse": { "type": "object", "properties": { "unreachable": { "description": "Locations that could not be reached when making an aggregated query using wildcards.", "type": "array", "items": { "type": "string" } }, "externalAccessRules": { "items": { "$ref": "ExternalAccessRule" }, "type": "array", "description": "A list of external access firewall rules." }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Response message for VmwareEngine.ListExternalAccessRules", "id": "ListExternalAccessRulesResponse" }, "IpRange": { "properties": { "ipAddress": { "description": "A single IP address. For example: `10.0.0.5`.", "type": "string" }, "ipAddressRange": { "description": "An IP address range in the CIDR format. For example: `10.0.0.0/24`.", "type": "string" }, "externalAddress": { "description": "The name of an `ExternalAddress` resource. The external address must have been reserved in the scope of this external access rule's parent network policy. Provide the external address name in the form of `projects/{project}/locations/{location}/privateClouds/{private_cloud}/externalAddresses/{external_address}`. For example: `projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address`.", "type": "string" } }, "description": "An IP range provided in any one of the supported formats.", "type": "object", "id": "IpRange" }, "Nsx": { "id": "Nsx", "type": "object", "description": "Details about a NSX Manager appliance.", "properties": { "fqdn": { "type": "string", "description": "Fully qualified domain name of the appliance." }, "state": { "description": "Output only. The state of the appliance.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING" ], "readOnly": true, "enumDescriptions": [ "Unspecified appliance state. This is the default value.", "The appliance is operational and can be used.", "The appliance is being deployed." ] }, "internalIp": { "description": "Internal IP address of the appliance.", "type": "string" }, "version": { "description": "Version of the appliance.", "type": "string" } } }, "Interval": { "type": "object", "id": "Interval", "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.", "properties": { "startTime": { "type": "string", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.", "format": "google-datetime" }, "endTime": { "format": "google-datetime", "type": "string", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end." } } }, "ListPrivateConnectionPeeringRoutesResponse": { "id": "ListPrivateConnectionPeeringRoutesResponse", "type": "object", "properties": { "peeringRoutes": { "type": "array", "description": "A list of peering routes.", "items": { "$ref": "PeeringRoute" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Response message for VmwareEngine.ListPrivateConnectionPeeringRoutes" }, "ListNodeTypesResponse": { "description": "Response message for VmwareEngine.ListNodeTypes", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "nodeTypes": { "type": "array", "items": { "$ref": "NodeType" }, "description": "A list of Node Types." }, "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached when making an aggregated query using wildcards.", "type": "array" } }, "id": "ListNodeTypesResponse", "type": "object" }, "ListManagementDnsZoneBindingsResponse": { "type": "object", "properties": { "managementDnsZoneBindings": { "type": "array", "description": "A list of management DNS zone bindings.", "items": { "$ref": "ManagementDnsZoneBinding" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached when making an aggregated query using wildcards.", "type": "array" } }, "id": "ListManagementDnsZoneBindingsResponse", "description": "Response message for VmwareEngine.ListManagementDnsZoneBindings" }, "ListExternalAddressesResponse": { "id": "ListExternalAddressesResponse", "properties": { "externalAddresses": { "items": { "$ref": "ExternalAddress" }, "description": "A list of external IP addresses.", "type": "array" }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "unreachable": { "items": { "type": "string" }, "description": "Locations that could not be reached when making an aggregated query using wildcards.", "type": "array" } }, "description": "Response message for VmwareEngine.ListExternalAddresses", "type": "object" }, "UndeletePrivateCloudRequest": { "type": "object", "id": "UndeletePrivateCloudRequest", "description": "Request message for VmwareEngine.UndeletePrivateCloud", "properties": { "requestId": { "description": "Optional. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" } } }, "ListHcxActivationKeysResponse": { "type": "object", "description": "Response message for VmwareEngine.ListHcxActivationKeys", "properties": { "hcxActivationKeys": { "items": { "$ref": "HcxActivationKey" }, "description": "List of HCX activation keys.", "type": "array" }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "unreachable": { "type": "array", "description": "Locations that could not be reached when making an aggregated query using wildcards.", "items": { "type": "string" } } }, "id": "ListHcxActivationKeysResponse" }, "AuditConfig": { "properties": { "service": { "description": "Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.", "type": "string" }, "auditLogConfigs": { "items": { "$ref": "AuditLogConfig" }, "type": "array", "description": "The configuration for logging of each type of permission." } }, "type": "object", "id": "AuditConfig", "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging." }, "Node": { "type": "object", "properties": { "version": { "description": "Output only. The version number of the VMware ESXi management component in this cluster.", "type": "string", "readOnly": true }, "customCoreCount": { "readOnly": true, "description": "Output only. Customized number of cores", "type": "string", "format": "int64" }, "name": { "type": "string", "description": "Output only. The resource name of this node. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster/nodes/my-node", "readOnly": true }, "internalIp": { "readOnly": true, "description": "Output only. Internal IP address of the node.", "type": "string" }, "fqdn": { "description": "Output only. Fully qualified domain name of the node.", "type": "string", "readOnly": true }, "nodeTypeId": { "readOnly": true, "type": "string", "description": "Output only. The canonical identifier of the node type (corresponds to the `NodeType`). For example: standard-72." }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "FAILED", "UPGRADING" ], "readOnly": true, "description": "Output only. The state of the appliance.", "enumDescriptions": [ "The default value. This value should never be used.", "Node is operational and can be used by the user.", "Node is being provisioned.", "Node is in a failed state.", "Node is undergoing maintenance, e.g.: during private cloud upgrade." ] } }, "id": "Node", "description": "Node in a cluster." }, "Principal": { "properties": { "user": { "description": "The user who needs to be granted permission.", "type": "string" }, "serviceAccount": { "description": "The service account which needs to be granted the permission.", "type": "string" } }, "description": "Users/Service accounts which have access for DNS binding on the intranet VPC corresponding to the consumer project.", "id": "Principal", "type": "object" }, "ManagementCluster": { "type": "object", "id": "ManagementCluster", "description": "Management cluster configuration.", "properties": { "clusterId": { "type": "string", "description": "Required. The user-provided identifier of the new `Cluster`. The identifier must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5)" }, "stretchedClusterConfig": { "description": "Optional. Configuration of a stretched cluster. Required for STRETCHED private clouds.", "$ref": "StretchedClusterConfig" }, "nodeTypeConfigs": { "additionalProperties": { "$ref": "NodeTypeConfig" }, "type": "object", "description": "Required. The map of cluster node types in this cluster, where the key is canonical identifier of the node type (corresponds to the `NodeType`)." } } }, "AutoscalingSettings": { "description": "Autoscaling settings define the rules used by VMware Engine to automatically scale-out and scale-in the clusters in a private cloud.", "id": "AutoscalingSettings", "type": "object", "properties": { "maxClusterNodeCount": { "type": "integer", "format": "int32", "description": "Optional. Maximum number of nodes of any type in a cluster. If not specified the default limits apply." }, "autoscalingPolicies": { "additionalProperties": { "$ref": "AutoscalingPolicy" }, "description": "Required. The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5) Currently there map must contain only one element that describes the autoscaling policy for compute nodes.", "type": "object" }, "minClusterNodeCount": { "format": "int32", "type": "integer", "description": "Optional. Minimum number of nodes of any type in a cluster. If not specified the default limits apply." }, "coolDownPeriod": { "description": "Optional. The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Defaults to 30 minutes if not specified. Cool down period must be in whole minutes (for example, 30, 31, 50, 180 minutes).", "format": "google-duration", "type": "string" } } }, "ListNodesResponse": { "type": "object", "description": "Response message for VmwareEngine.ListNodes", "properties": { "nodes": { "type": "array", "description": "The nodes.", "items": { "$ref": "Node" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "id": "ListNodesResponse" } }, "mtlsRootUrl": "https://vmwareengine.mtls.googleapis.com/", "protocol": "rest" }