{ "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "resources": { "projects": { "resources": { "locations": { "methods": { "list": { "id": "managedidentities.projects.locations.list", "path": "v1/{+name}/locations", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "parameters": { "name": { "description": "The resource that owns the locations collection, if applicable.", "pattern": "^projects/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, "pageSize": { "description": "The maximum number of results to return. If not set, the service selects a default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "ListLocationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists information about the supported locations for this service." }, "get": { "id": "managedidentities.projects.locations.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Resource name for the location.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Location" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets information about a location." } }, "resources": { "global": { "resources": { "operations": { "methods": { "list": { "id": "managedidentities.projects.locations.global.operations.list", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/operations", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/global/operations$", "location": "path", "required": true, "type": "string" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "description": "The standard list page size.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "ListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "get": { "id": "managedidentities.projects.locations.global.operations.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/global/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "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." }, "delete": { "id": "managedidentities.projects.locations.global.operations.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/global/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Empty" }, "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`." }, "cancel": { "id": "managedidentities.projects.locations.global.operations.cancel", "path": "v1/{+name}:cancel", "flatPath": "v1/projects/{projectsId}/locations/global/operations/{operationsId}:cancel", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/global/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "CancelOperationRequest" }, "response": { "$ref": "Empty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`." } } }, "domains": { "methods": { "create": { "id": "managedidentities.projects.locations.global.domains.create", "path": "v1/{+parent}/domains", "flatPath": "v1/projects/{projectsId}/locations/global/domains", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The resource project name and location using the form: `projects/{project_id}/locations/global`", "pattern": "^projects/[^/]+/locations/global$", "location": "path", "required": true, "type": "string" }, "domainName": { "description": "Required. The fully qualified domain name. e.g. mydomain.myorganization.com, with the following restrictions: * Must contain only lowercase letters, numbers, periods and hyphens. * Must start with a letter. * Must contain between 2-64 characters. * Must end with a number or a letter. * Must not start with period. * First segment length (mydomain for example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "Domain" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a Microsoft AD domain." }, "resetAdminPassword": { "id": "managedidentities.projects.locations.global.domains.resetAdminPassword", "path": "v1/{+name}:resetAdminPassword", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:resetAdminPassword", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "ResetAdminPasswordRequest" }, "response": { "$ref": "ResetAdminPasswordResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Resets a domain's administrator password." }, "list": { "id": "managedidentities.projects.locations.global.domains.list", "path": "v1/{+parent}/domains", "flatPath": "v1/projects/{projectsId}/locations/global/domains", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The resource name of the domain location using the form: `projects/{project_id}/locations/global`", "pattern": "^projects/[^/]+/locations/global$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used. Regardless of the page_size value, the response may include a partial list. Callers should rely on a response's next_page_token to determine if there are additional results to list.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. The `next_page_token` value returned from a previous ListDomainsRequest request, if any.", "location": "query", "type": "string" }, "filter": { "description": "Optional. A filter specifying constraints of a list operation. For example, `Domain.fqdn=\"mydomain.myorginization\"`.", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Specifies the ordering of results. See [Sorting order](https://cloud.google.com/apis/design/design_patterns#sorting_order) for more information.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListDomainsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists domains in a project." }, "get": { "id": "managedidentities.projects.locations.global.domains.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Domain" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets information about a domain." }, "patch": { "id": "managedidentities.projects.locations.global.domains.patch", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Required. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Required. Mask of fields to update. At least one path must be supplied in this field. The elements of the repeated paths field may only include fields from Domain: * `labels` * `locations` * `authorized_networks` * `audit_logs_enabled`", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "request": { "$ref": "Domain" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the metadata and configuration of a domain." }, "domainJoinMachine": { "id": "managedidentities.projects.locations.global.domains.domainJoinMachine", "path": "v1/{+domain}:domainJoinMachine", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:domainJoinMachine", "httpMethod": "POST", "parameters": { "domain": { "description": "Required. The domain resource name using the form: projects/{project_id}/locations/global/domains/{domain_name}", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "domain" ], "request": { "$ref": "DomainJoinMachineRequest" }, "response": { "$ref": "DomainJoinMachineResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "DomainJoinMachine API joins a Compute Engine VM to the domain" }, "restore": { "id": "managedidentities.projects.locations.global.domains.restore", "path": "v1/{+name}:restore", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:restore", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Resource name for the domain to which the backup belongs", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "RestoreDomainRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "RestoreDomain restores domain backup mentioned in the RestoreDomainRequest" }, "delete": { "id": "managedidentities.projects.locations.global.domains.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a domain." }, "attachTrust": { "id": "managedidentities.projects.locations.global.domains.attachTrust", "path": "v1/{+name}:attachTrust", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:attachTrust", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "AttachTrustRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Adds an AD trust to a domain." }, "reconfigureTrust": { "id": "managedidentities.projects.locations.global.domains.reconfigureTrust", "path": "v1/{+name}:reconfigureTrust", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:reconfigureTrust", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "ReconfigureTrustRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the DNS conditional forwarder." }, "detachTrust": { "id": "managedidentities.projects.locations.global.domains.detachTrust", "path": "v1/{+name}:detachTrust", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:detachTrust", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "DetachTrustRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Removes an AD trust." }, "validateTrust": { "id": "managedidentities.projects.locations.global.domains.validateTrust", "path": "v1/{+name}:validateTrust", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:validateTrust", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "ValidateTrustRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Validates a trust state, that the target domain is reachable, and that the target domain is able to accept incoming trust requests." }, "getLdapssettings": { "id": "managedidentities.projects.locations.global.domains.getLdapssettings", "path": "v1/{+name}/ldapssettings", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/ldapssettings", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "LDAPSSettings" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the domain ldaps settings." }, "updateLdapssettings": { "id": "managedidentities.projects.locations.global.domains.updateLdapssettings", "path": "v1/{+name}/ldapssettings", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/ldapssettings", "httpMethod": "PATCH", "parameters": { "name": { "description": "The resource name of the LDAPS settings. Uses the form: `projects/{project}/locations/{location}/domains/{domain}`.", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Required. Mask of fields to update. At least one path must be supplied in this field. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "request": { "$ref": "LDAPSSettings" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Patches a single ldaps settings." }, "extendSchema": { "id": "managedidentities.projects.locations.global.domains.extendSchema", "path": "v1/{+domain}:extendSchema", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:extendSchema", "httpMethod": "POST", "parameters": { "domain": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "domain" ], "request": { "$ref": "ExtendSchemaRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Extend Schema for Domain" }, "enableMigration": { "id": "managedidentities.projects.locations.global.domains.enableMigration", "path": "v1/{+domain}:enableMigration", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:enableMigration", "httpMethod": "POST", "parameters": { "domain": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "domain" ], "request": { "$ref": "EnableMigrationRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Enable Domain Migration" }, "disableMigration": { "id": "managedidentities.projects.locations.global.domains.disableMigration", "path": "v1/{+domain}:disableMigration", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:disableMigration", "httpMethod": "POST", "parameters": { "domain": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "domain" ], "request": { "$ref": "DisableMigrationRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Disable Domain Migration" }, "checkMigrationPermission": { "id": "managedidentities.projects.locations.global.domains.checkMigrationPermission", "path": "v1/{+domain}:checkMigrationPermission", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:checkMigrationPermission", "httpMethod": "POST", "parameters": { "domain": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "domain" ], "request": { "$ref": "CheckMigrationPermissionRequest" }, "response": { "$ref": "CheckMigrationPermissionResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "CheckMigrationPermission API gets the current state of DomainMigration" }, "setIamPolicy": { "id": "managedidentities.projects.locations.global.domains.setIamPolicy", "path": "v1/{+resource}:setIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "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.", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "response": { "$ref": "Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors." }, "getIamPolicy": { "id": "managedidentities.projects.locations.global.domains.getIamPolicy", "path": "v1/{+resource}:getIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:getIamPolicy", "httpMethod": "GET", "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/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" }, "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).", "location": "query", "type": "integer", "format": "int32" } }, "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set." }, "testIamPermissions": { "id": "managedidentities.projects.locations.global.domains.testIamPermissions", "path": "v1/{+resource}:testIamPermissions", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:testIamPermissions", "httpMethod": "POST", "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.", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "response": { "$ref": "TestIamPermissionsResponse" }, "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." } }, "resources": { "backups": { "methods": { "create": { "id": "managedidentities.projects.locations.global.domains.backups.create", "path": "v1/{+parent}/backups", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" }, "backupId": { "description": "Required. Backup Id, unique name to identify the backups with the following restrictions: * Must be lowercase letters, numbers, and hyphens * Must start with a letter. * Must contain between 1-63 characters. * Must end with a number or a letter. * Must be unique within the domain.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "Backup" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a Backup for a domain." }, "list": { "id": "managedidentities.projects.locations.global.domains.backups.list", "path": "v1/{+parent}/backups", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's next_page_token to determine if there are more instances left to be queried.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. The `next_page_token` value returned from a previous List request, if any.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter specifying constraints of a list operation.", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Specifies the ordering of results following syntax at https://cloud.google.com/apis/design/design_patterns#sorting_order.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListBackupsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists Backup in a given project." }, "get": { "id": "managedidentities.projects.locations.global.domains.backups.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups/{backupsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The backup resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}/backups/{backup_id}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Backup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single Backup." }, "patch": { "id": "managedidentities.projects.locations.global.domains.backups.patch", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups/{backupsId}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Output only. The unique name of the Backup in the form of `projects/{project_id}/locations/global/domains/{domain_name}/backups/{name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Required. Mask of fields to update. At least one path must be supplied in this field. The elements of the repeated paths field may only include these fields from Backup: * `labels`", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "request": { "$ref": "Backup" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the labels for specified Backup." }, "delete": { "id": "managedidentities.projects.locations.global.domains.backups.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups/{backupsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. The backup resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}/backups/{backup_id}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes identified Backup." }, "setIamPolicy": { "id": "managedidentities.projects.locations.global.domains.backups.setIamPolicy", "path": "v1/{+resource}:setIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups/{backupsId}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "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.", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "response": { "$ref": "Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors." }, "getIamPolicy": { "id": "managedidentities.projects.locations.global.domains.backups.getIamPolicy", "path": "v1/{+resource}:getIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups/{backupsId}:getIamPolicy", "httpMethod": "GET", "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/global/domains/[^/]+/backups/[^/]+$", "location": "path", "required": true, "type": "string" }, "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).", "location": "query", "type": "integer", "format": "int32" } }, "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set." }, "testIamPermissions": { "id": "managedidentities.projects.locations.global.domains.backups.testIamPermissions", "path": "v1/{+resource}:testIamPermissions", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/backups/{backupsId}:testIamPermissions", "httpMethod": "POST", "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.", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/backups/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "response": { "$ref": "TestIamPermissionsResponse" }, "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." } } }, "sqlIntegrations": { "methods": { "list": { "id": "managedidentities.projects.locations.global.domains.sqlIntegrations.list", "path": "v1/{+parent}/sqlIntegrations", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/sqlIntegrations", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The resource name of the SqlIntegrations using the form: `projects/{project_id}/locations/global/domains/*`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response'ANIZATIONs next_page_token to determine if there are more instances left to be queried.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. The next_page_token value returned from a previous List request, if any.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter specifying constraints of a list operation. For example, `SqlIntegration.name=\"sql\"`.", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Specifies the ordering of results following syntax at https://cloud.google.com/apis/design/design_patterns#sorting_order.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListSqlIntegrationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists SqlIntegrations in a given domain." }, "get": { "id": "managedidentities.projects.locations.global.domains.sqlIntegrations.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}/sqlIntegrations/{sqlIntegrationsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. SQLIntegration resource name using the form: `projects/{project_id}/locations/global/domains/{domain}/sqlIntegrations/{name}`", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+/sqlIntegrations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "SqlIntegration" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single sqlIntegration." } } } } }, "peerings": { "methods": { "create": { "id": "managedidentities.projects.locations.global.peerings.create", "path": "v1/{+parent}/peerings", "flatPath": "v1/projects/{projectsId}/locations/global/peerings", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Resource project name and location using the form: `projects/{project_id}/locations/global`", "pattern": "^projects/[^/]+/locations/global$", "location": "path", "required": true, "type": "string" }, "peeringId": { "description": "Required. Peering Id, unique name to identify peering. It should follow the regex format \"^(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)$\"", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "Peering" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a Peering for Managed AD instance." }, "list": { "id": "managedidentities.projects.locations.global.peerings.list", "path": "v1/{+parent}/peerings", "flatPath": "v1/projects/{projectsId}/locations/global/peerings", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The resource name of the peering location using the form: `projects/{project_id}/locations/global`", "pattern": "^projects/[^/]+/locations/global$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's next_page_token to determine if there are more instances left to be queried.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. The next_page_token value returned from a previous List request, if any.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter specifying constraints of a list operation. For example, `peering.authorized_network=\"projects/myprojectid/global/networks/mynetwork\"`.", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Specifies the ordering of results following syntax at https://cloud.google.com/apis/design/design_patterns#sorting_order.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListPeeringsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists Peerings in a given project." }, "get": { "id": "managedidentities.projects.locations.global.peerings.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/peerings/{peeringsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Peering resource name using the form: `projects/{project_id}/locations/global/peerings/{peering_id}`", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Peering" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single Peering." }, "patch": { "id": "managedidentities.projects.locations.global.peerings.patch", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/peerings/{peeringsId}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Output only. Unique name of the peering in this scope including projects and location using the form: `projects/{project_id}/locations/global/peerings/{peering_id}`.", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Required. Mask of fields to update. At least one path must be supplied in this field. The elements of the repeated paths field may only include these fields from Peering: * `labels`", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "request": { "$ref": "Peering" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the labels for specified Peering." }, "delete": { "id": "managedidentities.projects.locations.global.peerings.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/global/peerings/{peeringsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Peering resource name using the form: `projects/{project_id}/locations/global/peerings/{peering_id}`", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes identified Peering." }, "setIamPolicy": { "id": "managedidentities.projects.locations.global.peerings.setIamPolicy", "path": "v1/{+resource}:setIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/global/peerings/{peeringsId}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "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.", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "response": { "$ref": "Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors." }, "getIamPolicy": { "id": "managedidentities.projects.locations.global.peerings.getIamPolicy", "path": "v1/{+resource}:getIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/global/peerings/{peeringsId}:getIamPolicy", "httpMethod": "GET", "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/global/peerings/[^/]+$", "location": "path", "required": true, "type": "string" }, "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).", "location": "query", "type": "integer", "format": "int32" } }, "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set." }, "testIamPermissions": { "id": "managedidentities.projects.locations.global.peerings.testIamPermissions", "path": "v1/{+resource}:testIamPermissions", "flatPath": "v1/projects/{projectsId}/locations/global/peerings/{peeringsId}:testIamPermissions", "httpMethod": "POST", "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.", "pattern": "^projects/[^/]+/locations/global/peerings/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "response": { "$ref": "TestIamPermissionsResponse" }, "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." } } } } } } } } } }, "description": "The Managed Service for Microsoft Active Directory API is used for managing a highly available, hardened service running Microsoft Active Directory (AD).", "version_module": true, "servicePath": "", "basePath": "", "parameters": { "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "type": "string", "description": "Data format for response.", "default": "json", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "key": { "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.", "location": "query" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "quotaUser": { "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.", "location": "query" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "type": "string", "description": "V1 error format.", "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query" } }, "documentationLink": "https://cloud.google.com/managed-microsoft-ad/", "canonicalName": "Managed Service for Microsoft Active Directory Consumer API", "rootUrl": "https://managedidentities.googleapis.com/", "mtlsRootUrl": "https://managedidentities.mtls.googleapis.com/", "discoveryVersion": "v1", "ownerDomain": "google.com", "baseUrl": "https://managedidentities.googleapis.com/", "revision": "20240112", "batchPath": "batch", "kind": "discovery#restDescription", "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." } } } }, "id": "managedidentities:v1", "version": "v1", "fullyEncodeReservedExpansion": true, "title": "Managed Service for Microsoft Active Directory API", "ownerName": "Google", "schemas": { "ListLocationsResponse": { "id": "ListLocationsResponse", "description": "The response message for Locations.ListLocations.", "type": "object", "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Location" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "Location": { "id": "Location", "description": "A resource that represents a Google Cloud location.", "type": "object", "properties": { "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" }, "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "labels": { "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object", "additionalProperties": { "type": "string" } }, "metadata": { "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } }, "ListOperationsResponse": { "id": "ListOperationsResponse", "description": "The response message for Operations.ListOperations.", "type": "object", "properties": { "operations": { "description": "A list of operations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Operation" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "Operation": { "id": "Operation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "properties": { "name": { "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}`.", "type": "string" }, "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.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "done": { "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", "type": "boolean" }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "response": { "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } }, "Status": { "id": "Status", "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).", "type": "object", "properties": { "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } } }, "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": {} }, "CancelOperationRequest": { "id": "CancelOperationRequest", "description": "The request message for Operations.CancelOperation.", "type": "object", "properties": {} }, "Domain": { "id": "Domain", "description": "Represents a managed Microsoft Active Directory domain. If the domain is being changed, it will be placed into the UPDATING state, which indicates that the resource is being reconciled. At this point, Get will reflect an intermediate state.", "type": "object", "properties": { "name": { "description": "Required. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", "type": "string" }, "labels": { "description": "Optional. Resource labels that can contain user-provided metadata.", "type": "object", "additionalProperties": { "type": "string" } }, "authorizedNetworks": { "description": "Optional. The full names of the Google Compute Engine [networks](/compute/docs/networks-and-firewalls#networks) the domain instance is connected to. Networks can be added using UpdateDomain. The domain is only available on networks listed in `authorized_networks`. If CIDR subnets overlap between networks, domain creation will fail.", "type": "array", "items": { "type": "string" } }, "reservedIpRange": { "description": "Required. The CIDR range of internal addresses that are reserved for this domain. Reserved networks must be /24 or larger. Ranges must be unique and non-overlapping with existing subnets in [Domain].[authorized_networks].", "type": "string" }, "locations": { "description": "Required. Locations where domain needs to be provisioned. regions e.g. us-west1 or us-east4 Service supports up to 4 locations at once. Each location will use a /26 block.", "type": "array", "items": { "type": "string" } }, "admin": { "description": "Optional. The name of delegated administrator account used to perform Active Directory operations. If not specified, `setupadmin` will be used.", "type": "string" }, "fqdn": { "description": "Output only. The fully-qualified domain name of the exposed domain used by clients to connect to the service. Similar to what would be chosen for an Active Directory set up on an internal network.", "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the instance was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. The last update time.", "readOnly": true, "type": "string", "format": "google-datetime" }, "state": { "description": "Output only. The current state of this domain.", "readOnly": true, "type": "string", "enumDescriptions": [ "Not set.", "The domain is being created.", "The domain has been created and is fully usable.", "The domain's configuration is being updated.", "The domain is being deleted.", "The domain is being repaired and may be unusable. Details can be found in the `status_message` field.", "The domain is undergoing maintenance.", "The domain is not serving requests." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "READY", "UPDATING", "DELETING", "REPAIRING", "PERFORMING_MAINTENANCE", "UNAVAILABLE" ] }, "statusMessage": { "description": "Output only. Additional information about the current status of this domain, if available.", "readOnly": true, "type": "string" }, "trusts": { "description": "Output only. The current trusts associated with the domain.", "readOnly": true, "type": "array", "items": { "$ref": "Trust" } }, "auditLogsEnabled": { "description": "Optional. Configuration for audit logs. True if audit logs are enabled, else false. Default is audit logs disabled.", "type": "boolean" } } }, "Trust": { "id": "Trust", "description": "Represents a relationship between two domains. This allows a controller in one domain to authenticate a user in another domain. If the trust is being changed, it will be placed into the UPDATING state, which indicates that the resource is being reconciled. At this point, Get will reflect an intermediate state.", "type": "object", "properties": { "targetDomainName": { "description": "Required. The fully qualified target domain name which will be in trust with the current domain.", "type": "string" }, "trustType": { "description": "Required. The type of trust represented by the trust resource.", "type": "string", "enumDescriptions": [ "Not set.", "The forest trust.", "The external domain trust." ], "enum": [ "TRUST_TYPE_UNSPECIFIED", "FOREST", "EXTERNAL" ] }, "trustDirection": { "description": "Required. The trust direction, which decides if the current domain is trusted, trusting, or both.", "type": "string", "enumDescriptions": [ "Not set.", "The inbound direction represents the trusting side.", "The outboud direction represents the trusted side.", "The bidirectional direction represents the trusted / trusting side." ], "enum": [ "TRUST_DIRECTION_UNSPECIFIED", "INBOUND", "OUTBOUND", "BIDIRECTIONAL" ] }, "selectiveAuthentication": { "description": "Optional. The trust authentication type, which decides whether the trusted side has forest/domain wide access or selective access to an approved set of resources.", "type": "boolean" }, "targetDnsIpAddresses": { "description": "Required. The target DNS server IP addresses which can resolve the remote domain involved in the trust.", "type": "array", "items": { "type": "string" } }, "trustHandshakeSecret": { "description": "Required. The trust secret used for the handshake with the target domain. This will not be stored.", "type": "string" }, "createTime": { "description": "Output only. The time the instance was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. The last update time.", "readOnly": true, "type": "string", "format": "google-datetime" }, "state": { "description": "Output only. The current state of the trust.", "readOnly": true, "type": "string", "enumDescriptions": [ "Not set.", "The domain trust is being created.", "The domain trust is being updated.", "The domain trust is being deleted.", "The domain trust is connected.", "The domain trust is disconnected." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "UPDATING", "DELETING", "CONNECTED", "DISCONNECTED" ] }, "stateDescription": { "description": "Output only. Additional information about the current state of the trust, if available.", "readOnly": true, "type": "string" }, "lastTrustHeartbeatTime": { "description": "Output only. The last heartbeat time when the trust was known to be connected.", "readOnly": true, "type": "string", "format": "google-datetime" } } }, "ResetAdminPasswordRequest": { "id": "ResetAdminPasswordRequest", "description": "Request message for ResetAdminPassword", "type": "object", "properties": {} }, "ResetAdminPasswordResponse": { "id": "ResetAdminPasswordResponse", "description": "Response message for ResetAdminPassword", "type": "object", "properties": { "password": { "description": "A random password. See admin for more information.", "type": "string" } } }, "ListDomainsResponse": { "id": "ListDomainsResponse", "description": "Response message for ListDomains", "type": "object", "properties": { "domains": { "description": "A list of Managed Identities Service domains in the project.", "type": "array", "items": { "$ref": "Domain" } }, "nextPageToken": { "description": "A token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { "description": "A list of locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "DomainJoinMachineRequest": { "id": "DomainJoinMachineRequest", "description": "DomainJoinMachineRequest is the request message for DomainJoinMachine method", "type": "object", "properties": { "vmIdToken": { "description": "Required. Full instance id token of compute engine VM to verify instance identity. More about this: https://cloud.google.com/compute/docs/instances/verifying-instance-identity#request_signature", "type": "string" }, "ouName": { "description": "Optional. OU name where the VM needs to be domain joined", "type": "string" }, "force": { "description": "Optional. force if True, forces domain join even if the computer account already exists.", "type": "boolean" } } }, "DomainJoinMachineResponse": { "id": "DomainJoinMachineResponse", "description": "DomainJoinMachineResponse is the response message for DomainJoinMachine method", "type": "object", "properties": { "domainJoinBlob": { "description": "Offline domain join blob as the response", "type": "string" } } }, "RestoreDomainRequest": { "id": "RestoreDomainRequest", "description": "RestoreDomainRequest is the request received by RestoreDomain rpc", "type": "object", "properties": { "backupId": { "description": "Required. ID of the backup to be restored", "type": "string" } } }, "AttachTrustRequest": { "id": "AttachTrustRequest", "description": "Request message for AttachTrust", "type": "object", "properties": { "trust": { "description": "Required. The domain trust resource.", "$ref": "Trust" } } }, "ReconfigureTrustRequest": { "id": "ReconfigureTrustRequest", "description": "Request message for ReconfigureTrust", "type": "object", "properties": { "targetDomainName": { "description": "Required. The fully-qualified target domain name which will be in trust with current domain.", "type": "string" }, "targetDnsIpAddresses": { "description": "Required. The target DNS server IP addresses to resolve the remote domain involved in the trust.", "type": "array", "items": { "type": "string" } } } }, "DetachTrustRequest": { "id": "DetachTrustRequest", "description": "Request message for DetachTrust", "type": "object", "properties": { "trust": { "description": "Required. The domain trust resource to removed.", "$ref": "Trust" } } }, "ValidateTrustRequest": { "id": "ValidateTrustRequest", "description": "Request message for ValidateTrust", "type": "object", "properties": { "trust": { "description": "Required. The domain trust to validate trust state for.", "$ref": "Trust" } } }, "LDAPSSettings": { "id": "LDAPSSettings", "description": "LDAPSSettings represents the ldaps settings for domain resource. LDAP is the Lightweight Directory Access Protocol, defined in https://tools.ietf.org/html/rfc4511. The settings object configures LDAP over SSL/TLS, whether it is over port 636 or the StartTLS operation. If LDAPSSettings is being changed, it will be placed into the UPDATING state, which indicates that the resource is being reconciled. At this point, Get will reflect an intermediate state.", "type": "object", "properties": { "name": { "description": "The resource name of the LDAPS settings. Uses the form: `projects/{project}/locations/{location}/domains/{domain}`.", "type": "string" }, "certificate": { "description": "Output only. The certificate used to configure LDAPS. Certificates can be chained with a maximum length of 15.", "readOnly": true, "$ref": "Certificate" }, "state": { "description": "Output only. The current state of this LDAPS settings.", "readOnly": true, "type": "string", "enumDescriptions": [ "Not Set", "The LDAPS setting is being updated.", "The LDAPS setting is ready.", "The LDAPS setting is not applied correctly." ], "enum": [ "STATE_UNSPECIFIED", "UPDATING", "ACTIVE", "FAILED" ] }, "certificatePfx": { "description": "Input only. The uploaded PKCS12-formatted certificate to configure LDAPS with. It will enable the domain controllers in this domain to accept LDAPS connections (either LDAP over SSL/TLS or the StartTLS operation). A valid certificate chain must form a valid x.509 certificate chain (or be comprised of a single self-signed certificate. It must be encrypted with either: 1) PBES2 + PBKDF2 + AES256 encryption and SHA256 PRF; or 2) pbeWithSHA1And3-KeyTripleDES-CBC Private key must be included for the leaf / single self-signed certificate. Note: For a fqdn your-example-domain.com, the wildcard fqdn is *.your-example-domain.com. Specifically the leaf certificate must have: - Either a blank subject or a subject with CN matching the wildcard fqdn. - Exactly two SANs - the fqdn and wildcard fqdn. - Encipherment and digital key signature key usages. - Server authentication extended key usage (OID=1.3.6.1.5.5.7.3.1) - Private key must be in one of the following formats: RSA, ECDSA, ED25519. - Private key must have appropriate key length: 2048 for RSA, 256 for ECDSA - Signature algorithm of the leaf certificate cannot be MD2, MD5 or SHA1.", "type": "string", "format": "byte" }, "certificatePassword": { "description": "Input only. The password used to encrypt the uploaded PFX certificate.", "type": "string" }, "updateTime": { "description": "Output only. Last update time.", "readOnly": true, "type": "string", "format": "google-datetime" } } }, "Certificate": { "id": "Certificate", "description": "Certificate used to configure LDAPS.", "type": "object", "properties": { "subject": { "description": "The certificate subject.", "type": "string" }, "thumbprint": { "description": "The certificate thumbprint which uniquely identifies the certificate.", "type": "string" }, "subjectAlternativeName": { "description": "The additional hostnames for the domain.", "type": "array", "items": { "type": "string" } }, "issuingCertificate": { "description": "The issuer of this certificate.", "$ref": "Certificate" }, "expireTime": { "description": "The certificate expire time.", "type": "string", "format": "google-datetime" } } }, "Peering": { "id": "Peering", "description": "Represents a Managed Service for Microsoft Active Directory Peering.", "type": "object", "properties": { "name": { "description": "Output only. Unique name of the peering in this scope including projects and location using the form: `projects/{project_id}/locations/global/peerings/{peering_id}`.", "readOnly": true, "type": "string" }, "labels": { "description": "Optional. Resource labels to represent user-provided metadata.", "type": "object", "additionalProperties": { "type": "string" } }, "authorizedNetwork": { "description": "Required. The full names of the Google Compute Engine [networks](/compute/docs/networks-and-firewalls#networks) to which the instance is connected. Caller needs to make sure that CIDR subnets do not overlap between networks, else peering creation will fail.", "type": "string" }, "domainResource": { "description": "Required. Full domain resource path for the Managed AD Domain involved in peering. The resource path should be in the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "type": "string" }, "createTime": { "description": "Output only. The time the instance was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. Last update time.", "readOnly": true, "type": "string", "format": "google-datetime" }, "state": { "description": "Output only. The current state of this Peering.", "readOnly": true, "type": "string", "enumDescriptions": [ "Not set.", "Peering is being created.", "Peering is connected.", "Peering is disconnected.", "Peering is being deleted." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "CONNECTED", "DISCONNECTED", "DELETING" ] }, "statusMessage": { "description": "Output only. Additional information about the current status of this peering, if available.", "readOnly": true, "type": "string" } } }, "ListPeeringsResponse": { "id": "ListPeeringsResponse", "description": "ListPeeringsResponse is the response message for ListPeerings method.", "type": "object", "properties": { "peerings": { "description": "A list of Managed Identities Service Peerings in the project.", "type": "array", "items": { "$ref": "Peering" } }, "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "Backup": { "id": "Backup", "description": "Represents a Managed Microsoft Identities backup.", "type": "object", "properties": { "name": { "description": "Output only. The unique name of the Backup in the form of `projects/{project_id}/locations/global/domains/{domain_name}/backups/{name}`", "readOnly": true, "type": "string" }, "labels": { "description": "Optional. Resource labels to represent user provided metadata.", "type": "object", "additionalProperties": { "type": "string" } }, "createTime": { "description": "Output only. The time the backups was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. Last update time.", "readOnly": true, "type": "string", "format": "google-datetime" }, "type": { "description": "Output only. Indicates whether it’s an on-demand backup or scheduled.", "readOnly": true, "type": "string", "enumDescriptions": [ "Backup was manually created.", "Backup was manually created.", "Backup was automatically created." ], "enum": [ "TYPE_UNSPECIFIED", "ON_DEMAND", "SCHEDULED" ] }, "state": { "description": "Output only. The current state of the backup.", "readOnly": true, "type": "string", "enumDescriptions": [ "Not set.", "Backup is being created.", "Backup has been created and validated.", "Backup has been created but failed validation.", "Backup is being deleted." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "FAILED", "DELETING" ] }, "statusMessage": { "description": "Output only. Additional information about the current status of this backup, if available.", "readOnly": true, "type": "string" } } }, "ListBackupsResponse": { "id": "ListBackupsResponse", "description": "ListBackupsResponse is the response message for ListBackups method.", "type": "object", "properties": { "backups": { "description": "A list of Cloud AD backups in the domain.", "type": "array", "items": { "$ref": "Backup" } }, "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "ListSqlIntegrationsResponse": { "id": "ListSqlIntegrationsResponse", "description": "ListSqlIntegrationsResponse is the response message for ListSqlIntegrations method.", "type": "object", "properties": { "sqlIntegrations": { "description": "A list of SQLIntegrations of a domain.", "type": "array", "items": { "$ref": "SqlIntegration" } }, "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { "description": "A list of locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "SqlIntegration": { "id": "SqlIntegration", "description": "Represents the SQL instance integrated with Managed AD.", "type": "object", "properties": { "name": { "description": "The unique name of the SQL integration in the form of `projects/{project_id}/locations/global/domains/{domain_name}/sqlIntegrations/{sql_integration}`", "type": "string" }, "sqlInstance": { "description": "The full resource name of an integrated SQL instance", "type": "string" }, "createTime": { "description": "Output only. The time the SQL integration was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. The time the SQL integration was updated.", "readOnly": true, "type": "string", "format": "google-datetime" }, "state": { "description": "Output only. The current state of the SQL integration.", "readOnly": true, "type": "string", "enumDescriptions": [ "Not Set", "The SQL integration is being created.", "The SQL integration is being deleted.", "The SQL integration is ready." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "DELETING", "READY" ] } } }, "ExtendSchemaRequest": { "id": "ExtendSchemaRequest", "description": "ExtendSchemaRequest is the request message for ExtendSchema method.", "type": "object", "properties": { "description": { "description": "Required. Description for Schema Change.", "type": "string" }, "gcsPath": { "description": "File stored in Cloud Storage bucket and represented in the form projects/{project_id}/buckets/{bucket_name}/objects/{object_name} File should be in the same project as the domain.", "type": "string" }, "fileContents": { "description": "File uploaded as a byte stream input.", "type": "string", "format": "byte" } } }, "EnableMigrationRequest": { "id": "EnableMigrationRequest", "description": "EnableMigrationRequest is the request message for EnableMigration method.", "type": "object", "properties": { "migratingDomains": { "description": "Required. List of the on-prem domains to be migrated.", "type": "array", "items": { "$ref": "OnPremDomainDetails" } } } }, "OnPremDomainDetails": { "id": "OnPremDomainDetails", "description": "OnPremDomainDetails is the message which contains details of on-prem domain which is trusted and needs to be migrated.", "type": "object", "properties": { "domainName": { "description": "Required. FQDN of the on-prem domain being migrated.", "type": "string" }, "disableSidFiltering": { "description": "Optional. Option to disable SID filtering.", "type": "boolean" } } }, "DisableMigrationRequest": { "id": "DisableMigrationRequest", "description": "DisableMigrationRequest is the request message for DisableMigration method.", "type": "object", "properties": {} }, "CheckMigrationPermissionRequest": { "id": "CheckMigrationPermissionRequest", "description": "CheckMigrationPermissionRequest is the request message for CheckMigrationPermission method.", "type": "object", "properties": {} }, "CheckMigrationPermissionResponse": { "id": "CheckMigrationPermissionResponse", "description": "CheckMigrationPermissionResponse is the response message for CheckMigrationPermission method.", "type": "object", "properties": { "state": { "description": "The state of DomainMigration.", "type": "string", "enumDescriptions": [ "DomainMigration is in unspecified state.", "Domain Migration is Disabled.", "Domain Migration is Enabled.", "Domain Migration is not in valid state." ], "enum": [ "STATE_UNSPECIFIED", "DISABLED", "ENABLED", "NEEDS_MAINTENANCE" ] }, "onpremDomains": { "description": "The state of SID filtering of all the domains which has trust established.", "type": "array", "items": { "$ref": "OnPremDomainSIDDetails" } } } }, "OnPremDomainSIDDetails": { "id": "OnPremDomainSIDDetails", "description": "OnPremDomainDetails is the message which contains details of on-prem domain which is trusted and needs to be migrated.", "type": "object", "properties": { "name": { "description": "FQDN of the on-prem domain being migrated.", "type": "string" }, "sidFilteringState": { "description": "Current SID filtering state.", "type": "string", "enumDescriptions": [ "SID Filtering is in unspecified state.", "SID Filtering is Enabled.", "SID Filtering is Disabled." ], "enum": [ "SID_FILTERING_STATE_UNSPECIFIED", "ENABLED", "DISABLED" ] } } }, "SetIamPolicyRequest": { "id": "SetIamPolicyRequest", "description": "Request message for `SetIamPolicy` method.", "type": "object", "properties": { "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.", "$ref": "Policy" } } }, "Policy": { "id": "Policy", "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", "properties": { "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).", "type": "integer", "format": "int32" }, "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`.", "type": "array", "items": { "$ref": "Binding" } }, "etag": { "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.", "type": "string", "format": "byte" } } }, "Binding": { "id": "Binding", "description": "Associates `members`, or principals, with a `role`.", "type": "object", "properties": { "role": { "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.", "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`.", "type": "array", "items": { "type": "string" } }, "condition": { "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).", "$ref": "Expr" } } }, "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": { "expression": { "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "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" }, "description": { "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", "type": "string" }, "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" } } }, "TestIamPermissionsRequest": { "id": "TestIamPermissionsRequest", "description": "Request message for `TestIamPermissions` method.", "type": "object", "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).", "type": "array", "items": { "type": "string" } } } }, "TestIamPermissionsResponse": { "id": "TestIamPermissionsResponse", "description": "Response message for `TestIamPermissions` method.", "type": "object", "properties": { "permissions": { "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "type": "array", "items": { "type": "string" } } } }, "OperationMetadata": { "id": "OperationMetadata", "description": "Represents the metadata of the long-running operation.", "type": "object", "properties": { "createTime": { "description": "Output only. The time the operation was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "endTime": { "description": "Output only. The time the operation finished running.", "readOnly": true, "type": "string", "format": "google-datetime" }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "verb": { "description": "Output only. Name of the verb executed by the operation.", "readOnly": true, "type": "string" }, "statusDetail": { "description": "Output only. Human-readable status of the operation, if any.", "readOnly": true, "type": "string" }, "cancelRequested": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", "readOnly": true, "type": "boolean" }, "apiVersion": { "description": "Output only. API version used to start the operation.", "readOnly": true, "type": "string" } } }, "GoogleCloudManagedidentitiesV1OpMetadata": { "id": "GoogleCloudManagedidentitiesV1OpMetadata", "description": "Represents the metadata of the long-running operation.", "type": "object", "properties": { "createTime": { "description": "Output only. The time the operation was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "endTime": { "description": "Output only. The time the operation finished running.", "readOnly": true, "type": "string", "format": "google-datetime" }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "verb": { "description": "Output only. Name of the verb executed by the operation.", "readOnly": true, "type": "string" }, "requestedCancellation": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. 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" }, "apiVersion": { "description": "Output only. API version used to start the operation.", "readOnly": true, "type": "string" } } }, "GoogleCloudManagedidentitiesV1alpha1OpMetadata": { "id": "GoogleCloudManagedidentitiesV1alpha1OpMetadata", "description": "Represents the metadata of the long-running operation.", "type": "object", "properties": { "createTime": { "description": "Output only. The time the operation was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "endTime": { "description": "Output only. The time the operation finished running.", "readOnly": true, "type": "string", "format": "google-datetime" }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "verb": { "description": "Output only. Name of the verb executed by the operation.", "readOnly": true, "type": "string" }, "requestedCancellation": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. 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" }, "apiVersion": { "description": "Output only. API version used to start the operation.", "readOnly": true, "type": "string" } } }, "GoogleCloudManagedidentitiesV1beta1OpMetadata": { "id": "GoogleCloudManagedidentitiesV1beta1OpMetadata", "description": "Represents the metadata of the long-running operation.", "type": "object", "properties": { "createTime": { "description": "Output only. The time the operation was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "endTime": { "description": "Output only. The time the operation finished running.", "readOnly": true, "type": "string", "format": "google-datetime" }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "verb": { "description": "Output only. Name of the verb executed by the operation.", "readOnly": true, "type": "string" }, "requestedCancellation": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. 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" }, "apiVersion": { "description": "Output only. API version used to start the operation.", "readOnly": true, "type": "string" } } }, "GoogleCloudSaasacceleratorManagementProvidersV1Instance": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange", "type": "object", "properties": { "name": { "description": "Unique name of the resource. It uses the form: `projects/{project_number}/locations/{location_id}/instances/{instance_id}` Note: This name is passed, stored and logged across the rollout system. So use of consumer project_id or any other consumer PII in the name is strongly discouraged for wipeout (go/wipeout) compliance. See go/elysium/project_ids#storage-guidance for more details.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when the resource was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. Timestamp when the resource was last modified.", "readOnly": true, "type": "string", "format": "google-datetime" }, "labels": { "description": "Optional. Resource labels to represent user provided metadata. Each label is a key-value pair, where both the key and the value are arbitrary strings provided by the user.", "type": "object", "additionalProperties": { "type": "string" } }, "state": { "description": "Output only. Current lifecycle state of the resource (e.g. if it's being created or ready to use).", "readOnly": true, "type": "string", "enumDescriptions": [ "Unspecified state.", "Instance is being created.", "Instance has been created and is ready to use.", "Instance is being updated.", "Instance is unheathy and under repair.", "Instance is being deleted.", "Instance encountered an error and is in indeterministic state." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "READY", "UPDATING", "REPAIRING", "DELETING", "ERROR" ] }, "softwareVersions": { "description": "Software versions that are used to deploy this instance. This can be mutated by rollout services.", "type": "object", "additionalProperties": { "type": "string" } }, "maintenancePolicyNames": { "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For details, please refer to go/mr-user-guide. Should not be set if maintenance_settings.maintenance_policies is set.", "type": "object", "additionalProperties": { "type": "string" } }, "tenantProjectId": { "description": "Output only. ID of the associated GCP tenant project. See go/get-instance-metadata.", "readOnly": true, "type": "string" }, "producerMetadata": { "description": "Output only. Custom string attributes used primarily to expose producer-specific information in monitoring dashboards. See go/get-instance-metadata.", "readOnly": true, "type": "object", "additionalProperties": { "type": "string" } }, "provisionedResources": { "description": "Output only. The list of data plane resources provisioned for this instance, e.g. compute VMs. See go/get-instance-metadata.", "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource" } }, "sloMetadata": { "description": "Output only. SLO metadata for instance classification in the Standardized dataplane SLO platform. See go/cloud-ssa-standard-slo for feature description.", "readOnly": true, "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata" }, "maintenanceSchedules": { "description": "The MaintenanceSchedule contains the scheduling information of published maintenance schedule with same key as software_versions.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule" } }, "consumerDefinedName": { "description": "consumer_defined_name is the name of the instance set by the service consumers. Generally this is different from the `name` field which reperesents the system-assigned id of the instance which the service consumers do not recognize. This is a required field for tenants onboarding to Maintenance Window notifications (go/slm-rollout-maintenance-policies#prerequisites).", "type": "string" }, "slmInstanceTemplate": { "description": "Link to the SLM instance template. Only populated when updating SLM instances via SSA's Actuation service adaptor. Service producers with custom control plane (e.g. Cloud SQL) doesn't need to populate this field. Instead they should use software_versions.", "type": "string" }, "maintenanceSettings": { "description": "Optional. The MaintenanceSettings associated with instance.", "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings" }, "instanceType": { "description": "Optional. The instance_type of this instance of format: projects/{project_number}/locations/{location_id}/instanceTypes/{instance_type_id}. Instance Type represents a high-level tier or SKU of the service that this instance belong to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along with 'software_versions' to determine whether instance needs an update or not.", "type": "string" }, "notificationParameters": { "description": "Optional. notification_parameter are information that service producers may like to include that is not relevant to Rollout. This parameter will only be passed to Gamma and Cloud Logging for notification/logging purpose.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter" } } } }, "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource", "description": "Describes provisioned dataplane resources.", "type": "object", "properties": { "resourceType": { "description": "Type of the resource. This can be either a GCP resource or a custom one (e.g. another cloud provider's VM). For GCP compute resources use singular form of the names listed in GCP compute API documentation (https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with 'compute-', for example: 'compute-instance', 'compute-disk', 'compute-autoscaler'.", "type": "string" }, "resourceUrl": { "description": "URL identifying the resource, e.g. \"https://www.googleapis.com/compute/v1/projects/...)\".", "type": "string" } } }, "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata", "description": "SloMetadata contains resources required for proper SLO classification of the instance.", "type": "object", "properties": { "tier": { "description": "Name of the SLO tier the Instance belongs to. This name will be expected to match the tiers specified in the service SLO configuration. Field is mandatory and must not be empty.", "type": "string" }, "nodes": { "description": "Optional. List of nodes. Some producers need to use per-node metadata to calculate SLO. This field allows such producers to publish per-node SLO meta data, which will be consumed by SSA Eligibility Exporter and published in the form of per node metric to Monarch.", "type": "array", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata" } }, "perSliEligibility": { "description": "Optional. Multiple per-instance SLI eligibilities which apply for individual SLIs.", "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility" } } }, "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata", "description": "Node information for custom per-node SLO implementations. SSA does not support per-node SLO, but producers can populate per-node information in SloMetadata for custom precomputations. SSA Eligibility Exporter will emit per-node metric based on this information.", "type": "object", "properties": { "nodeId": { "description": "The id of the node. This should be equal to SaasInstanceNode.node_id.", "type": "string" }, "location": { "description": "The location of the node, if different from instance location.", "type": "string" }, "perSliEligibility": { "description": "If present, this will override eligibility for the node coming from instance or exclusions for specified SLIs.", "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility" } } }, "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility", "description": "PerSliSloEligibility is a mapping from an SLI name to eligibility.", "type": "object", "properties": { "eligibilities": { "description": "An entry in the eligibilities map specifies an eligibility for a particular SLI for the given instance. The SLI key in the name must be a valid SLI name specified in the Eligibility Exporter binary flags otherwise an error will be emitted by Eligibility Exporter and the oncaller will be alerted. If an SLI has been defined in the binary flags but the eligibilities map does not contain it, the corresponding SLI time series will not be emitted by the Eligibility Exporter. This ensures a smooth rollout and compatibility between the data produced by different versions of the Eligibility Exporters. If eligibilities map contains a key for an SLI which has not been declared in the binary flags, there will be an error message emitted in the Eligibility Exporter log and the metric for the SLI in question will not be emitted.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility" } } } }, "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility", "description": "SloEligibility is a tuple containing eligibility value: true if an instance is eligible for SLO calculation or false if it should be excluded from all SLO-related calculations along with a user-defined reason.", "type": "object", "properties": { "eligible": { "description": "Whether an instance is eligible or ineligible.", "type": "boolean" }, "reason": { "description": "User-defined reason for the current value of instance eligibility. Usually, this can be directly mapped to the internal state. An empty reason is allowed.", "type": "string" } } }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule", "description": "Maintenance schedule which is exposed to customer and potentially end user, indicating published upcoming future maintenance schedule", "type": "object", "properties": { "startTime": { "description": "The scheduled start time for the maintenance.", "type": "string", "format": "google-datetime" }, "endTime": { "description": "The scheduled end time for the maintenance.", "type": "string", "format": "google-datetime" }, "canReschedule": { "description": "This field is deprecated, and will be always set to true since reschedule can happen multiple times now. This field should not be removed until all service producers remove this for their customers.", "deprecated": true, "type": "boolean" }, "rolloutManagementPolicy": { "description": "The rollout management policy this maintenance schedule is associated with. When doing reschedule update request, the reschedule should be against this given policy.", "type": "string" }, "scheduleDeadlineTime": { "description": "schedule_deadline_time is the time deadline any schedule start time cannot go beyond, including reschedule. It's normally the initial schedule start time plus maintenance window length (1 day or 1 week). Maintenance cannot be scheduled to start beyond this deadline.", "type": "string", "format": "google-datetime" } } }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings", "description": "Maintenance settings associated with instance. Allows service producers and end users to assign settings that controls maintenance on this instance.", "type": "object", "properties": { "exclude": { "description": "Optional. Exclude instance from maintenance. When true, rollout service will not attempt maintenance on the instance. Rollout service will include the instance in reported rollout progress as not attempted.", "type": "boolean" }, "maintenancePolicies": { "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For details, please refer to go/mr-user-guide. Should not be set if maintenance_policy_names is set. If only the name is needed, then only populate MaintenancePolicy.name.", "type": "object", "additionalProperties": { "$ref": "MaintenancePolicy" } }, "isRollback": { "description": "Optional. If the update call is triggered from rollback, set the value as true.", "type": "boolean" } } }, "MaintenancePolicy": { "id": "MaintenancePolicy", "description": "LINT.IfChange Defines policies to service maintenance events.", "type": "object", "properties": { "name": { "description": "Required. MaintenancePolicy name using the form: `projects/{project_id}/locations/{location_id}/maintenancePolicies/{maintenance_policy_id}` where {project_id} refers to a GCP consumer project ID, {location_id} refers to a GCP region/zone, {maintenance_policy_id} must be 1-63 characters long and match the regular expression `[a-z0-9]([-a-z0-9]*[a-z0-9])?`.", "type": "string" }, "createTime": { "description": "Output only. The time when the resource was created.", "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. The time when the resource was updated.", "type": "string", "format": "google-datetime" }, "description": { "description": "Optional. Description of what this policy is for. Create/Update methods return INVALID_ARGUMENT if the length is greater than 512.", "type": "string" }, "labels": { "description": "Optional. Resource labels to represent user provided metadata. Each label is a key-value pair, where both the key and the value are arbitrary strings provided by the user.", "type": "object", "additionalProperties": { "type": "string" } }, "state": { "description": "Optional. The state of the policy.", "type": "string", "enumDescriptions": [ "Unspecified state.", "Resource is ready to be used.", "Resource is being deleted. It can no longer be attached to instances." ], "enum": [ "STATE_UNSPECIFIED", "READY", "DELETING" ] }, "updatePolicy": { "description": "Maintenance policy applicable to instance update.", "$ref": "UpdatePolicy" } } }, "UpdatePolicy": { "id": "UpdatePolicy", "description": "Maintenance policy applicable to instance updates.", "type": "object", "properties": { "window": { "description": "Optional. Maintenance window that is applied to resources covered by this policy.", "$ref": "MaintenanceWindow" }, "channel": { "description": "Optional. Relative scheduling channel applied to resource.", "type": "string", "enumDescriptions": [ "Unspecified channel.", "Early channel within a customer project.", "Later channel within a customer project.", "! ! The follow channels can ONLY be used if you adopt the new MW system! ! ! NOTE: all WEEK channels are assumed to be under a weekly window. ! There is currently no dedicated channel definitions for Daily windows. ! If you use Daily window, the system will assume a 1d (24Hours) advanced ! notification period b/w EARLY and LATER. ! We may consider support more flexible daily channel specifications in ! the future. WEEK1 == EARLIER with minimum 7d advanced notification. {7d, 14d} The system will treat them equally and will use WEEK1 whenever it can. New customers are encouraged to use this channel annotation.", "WEEK2 == LATER with minimum 14d advanced notification {14d, 21d}.", "WEEK5 == 40d support. minimum 35d advanced notification {35d, 42d}." ], "enum": [ "UPDATE_CHANNEL_UNSPECIFIED", "EARLIER", "LATER", "WEEK1", "WEEK2", "WEEK5" ] }, "denyMaintenancePeriods": { "description": "Deny Maintenance Period that is applied to resource to indicate when maintenance is forbidden. The protocol supports zero-to-many such periods, but the current SLM Rollout implementation only supports zero-to-one.", "type": "array", "items": { "$ref": "DenyMaintenancePeriod" } } } }, "MaintenanceWindow": { "id": "MaintenanceWindow", "description": "MaintenanceWindow definition.", "type": "object", "properties": { "dailyCycle": { "description": "Daily cycle.", "$ref": "DailyCycle" }, "weeklyCycle": { "description": "Weekly cycle.", "$ref": "WeeklyCycle" } } }, "DailyCycle": { "id": "DailyCycle", "description": "Time window specified for daily operations.", "type": "object", "properties": { "startTime": { "description": "Time within the day to start the operations.", "$ref": "TimeOfDay" }, "duration": { "description": "Output only. Duration of the time window, set by service producer.", "type": "string", "format": "google-duration" } } }, "TimeOfDay": { "id": "TimeOfDay", "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`.", "type": "object", "properties": { "hours": { "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "type": "integer", "format": "int32" }, "minutes": { "description": "Minutes of hour of day. Must be from 0 to 59.", "type": "integer", "format": "int32" }, "seconds": { "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.", "type": "integer", "format": "int32" }, "nanos": { "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", "type": "integer", "format": "int32" } } }, "WeeklyCycle": { "id": "WeeklyCycle", "description": "Time window specified for weekly operations.", "type": "object", "properties": { "schedule": { "description": "User can specify multiple windows in a week. Minimum of 1 window.", "type": "array", "items": { "$ref": "Schedule" } } } }, "Schedule": { "id": "Schedule", "description": "Configure the schedule.", "type": "object", "properties": { "day": { "description": "Allows to define schedule that runs specified day of the week.", "type": "string", "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ] }, "startTime": { "description": "Time within the window to start the operations.", "$ref": "TimeOfDay" }, "duration": { "description": "Output only. Duration of the time window, set by service producer.", "type": "string", "format": "google-duration" } } }, "DenyMaintenancePeriod": { "id": "DenyMaintenancePeriod", "description": "DenyMaintenancePeriod definition. Maintenance is forbidden within the deny period. The start_date must be less than the end_date.", "type": "object", "properties": { "startDate": { "description": "Deny period start date. This can be: * A full date, with non-zero year, month and day values. * A month and day value, with a zero year. Allows recurring deny periods each year. Date matching this period will have to be the same or after the start.", "$ref": "Date" }, "endDate": { "description": "Deny period end date. This can be: * A full date, with non-zero year, month and day values. * A month and day value, with a zero year. Allows recurring deny periods each year. Date matching this period will have to be before the end.", "$ref": "Date" }, "time": { "description": "Time in UTC when the Blackout period starts on start_date and ends on end_date. This can be: * Full time. * All zeros for 00:00:00 UTC", "$ref": "TimeOfDay" } } }, "Date": { "id": "Date", "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "type": "object", "properties": { "year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "type": "integer", "format": "int32" }, "month": { "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "type": "integer", "format": "int32" }, "day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "type": "integer", "format": "int32" } } }, "GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter": { "id": "GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter", "description": "Contains notification related data.", "type": "object", "properties": { "values": { "description": "Optional. Array of string values. e.g. instance's replica information.", "type": "array", "items": { "type": "string" } } } } }, "protocol": "rest", "name": "managedidentities" }