From 120d84bcd6c6f6d024336cd3b16b08d2170997ac Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Mon, 3 Aug 2020 04:29:04 -0700 Subject: [PATCH] feat(managedidentities): update the API #### managedidentities:v1alpha1 The following keys were added: - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.createTime.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.producerMetadata.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.provisionedResources.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.sloMetadata.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.state.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.tenantProjectId.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.updateTime.readOnly The following keys were changed: - resources.projects.resources.locations.methods.list.parameters.includeUnrevealedLocations.description - resources.projects.resources.locations.resources.global.resources.domains.methods.attachTrust.description - resources.projects.resources.locations.resources.global.resources.domains.methods.attachTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.create.description - resources.projects.resources.locations.resources.global.resources.domains.methods.create.parameters.domainName.description - resources.projects.resources.locations.resources.global.resources.domains.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.global.resources.domains.methods.delete.description - resources.projects.resources.locations.resources.global.resources.domains.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.detachTrust.description - resources.projects.resources.locations.resources.global.resources.domains.methods.detachTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.get.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.parameters.options.requestedPolicyVersion.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.filter.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.orderBy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.global.resources.domains.methods.patch.description - resources.projects.resources.locations.resources.global.resources.domains.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.patch.parameters.updateMask.description - resources.projects.resources.locations.resources.global.resources.domains.methods.reconfigureTrust.description - resources.projects.resources.locations.resources.global.resources.domains.methods.reconfigureTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.resetAdminPassword.description - resources.projects.resources.locations.resources.global.resources.domains.methods.resetAdminPassword.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.setIamPolicy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.setIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.testIamPermissions.description - resources.projects.resources.locations.resources.global.resources.domains.methods.testIamPermissions.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.validateTrust.description - resources.projects.resources.locations.resources.global.resources.domains.methods.validateTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.operations.methods.cancel.description - resources.projects.resources.locations.resources.global.resources.operations.methods.delete.description - resources.projects.resources.locations.resources.global.resources.operations.methods.get.description - resources.projects.resources.locations.resources.global.resources.operations.methods.list.description - schemas.Binding.properties.condition.description - schemas.Binding.properties.members.description - schemas.Binding.properties.role.description - schemas.Domain.properties.authorizedNetworks.description - schemas.Domain.properties.createTime.description - schemas.Domain.properties.fqdn.description - schemas.Domain.properties.locations.description - schemas.Domain.properties.managedIdentitiesAdminName.description - schemas.Domain.properties.name.description - schemas.Domain.properties.reservedIpRange.description - schemas.Domain.properties.state.enumDescriptions - schemas.Domain.properties.statusMessage.description - schemas.Domain.properties.updateTime.description - schemas.Empty.description - schemas.Expr.description - schemas.Expr.properties.description.description - schemas.Expr.properties.expression.description - schemas.Expr.properties.location.description - schemas.Expr.properties.title.description - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.consumerDefinedName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.labels.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenancePolicyNames.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenanceSchedules.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.name.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.producerMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.provisionedResources.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.slmInstanceTemplate.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.sloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.softwareVersions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.state.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.tenantProjectId.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.canReschedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.rolloutManagementPolicy.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.properties.exclude.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.properties.exclusions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.properties.nodeId.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource.properties.resourceType.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource.properties.resourceUrl.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility.properties.reason.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.duration.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.reason.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.sliName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.exclusions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.nodes.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.tier.description - schemas.ListDomainsResponse.properties.nextPageToken.description - schemas.Location.properties.displayName.description - schemas.Location.properties.labels.description - schemas.Location.properties.metadata.description - schemas.Location.properties.name.description - schemas.Operation.description - schemas.Operation.properties.done.description - schemas.Operation.properties.metadata.description - schemas.Operation.properties.name.description - schemas.Operation.properties.response.description - schemas.OperationMetadata.properties.cancelRequested.description - schemas.Policy.description - schemas.Policy.properties.bindings.description - schemas.Policy.properties.etag.description - schemas.Policy.properties.version.description - schemas.SetIamPolicyRequest.properties.policy.description - schemas.Status.description - schemas.Status.properties.details.description - schemas.Status.properties.message.description - schemas.TestIamPermissionsRequest.properties.permissions.description - schemas.TestIamPermissionsResponse.properties.permissions.description - schemas.Trust.description - schemas.Trust.properties.lastKnownTrustConnectedHeartbeatTime.description - schemas.Trust.properties.selectiveAuthentication.description - schemas.Trust.properties.stateDescription.description - schemas.Trust.properties.targetDnsIpAddresses.description - schemas.Trust.properties.targetDomainName.description - schemas.Trust.properties.trustDirection.description - schemas.Trust.properties.trustHandshakeSecret.description #### managedidentities:v1 The following keys were added: - schemas.Domain.properties.createTime.readOnly - schemas.Domain.properties.fqdn.readOnly - schemas.Domain.properties.state.readOnly - schemas.Domain.properties.statusMessage.readOnly - schemas.Domain.properties.trusts.readOnly - schemas.Domain.properties.updateTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.createTime.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.producerMetadata.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.provisionedResources.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.sloMetadata.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.state.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.tenantProjectId.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.updateTime.readOnly - schemas.Trust.properties.createTime.readOnly - schemas.Trust.properties.lastTrustHeartbeatTime.readOnly - schemas.Trust.properties.state.readOnly - schemas.Trust.properties.stateDescription.readOnly - schemas.Trust.properties.updateTime.readOnly The following keys were changed: - resources.projects.resources.locations.methods.list.parameters.includeUnrevealedLocations.description - resources.projects.resources.locations.resources.global.resources.domains.methods.attachTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.create.parameters.domainName.description - resources.projects.resources.locations.resources.global.resources.domains.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.global.resources.domains.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.detachTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.get.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.parameters.options.requestedPolicyVersion.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.filter.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.orderBy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.pageToken.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.global.resources.domains.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.patch.parameters.updateMask.description - resources.projects.resources.locations.resources.global.resources.domains.methods.reconfigureTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.resetAdminPassword.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.setIamPolicy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.setIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.testIamPermissions.description - resources.projects.resources.locations.resources.global.resources.domains.methods.testIamPermissions.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.validateTrust.description - resources.projects.resources.locations.resources.global.resources.domains.methods.validateTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.operations.methods.cancel.description - resources.projects.resources.locations.resources.global.resources.operations.methods.delete.description - resources.projects.resources.locations.resources.global.resources.operations.methods.get.description - resources.projects.resources.locations.resources.global.resources.operations.methods.list.description - schemas.AttachTrustRequest.description - schemas.Binding.properties.condition.description - schemas.Binding.properties.members.description - schemas.Binding.properties.role.description - schemas.DetachTrustRequest.description - schemas.Domain.properties.admin.description - schemas.Domain.properties.authorizedNetworks.description - schemas.Domain.properties.fqdn.description - schemas.Domain.properties.locations.description - schemas.Domain.properties.name.description - schemas.Domain.properties.reservedIpRange.description - schemas.Domain.properties.state.enumDescriptions - schemas.Domain.properties.statusMessage.description - schemas.Empty.description - schemas.Expr.description - schemas.Expr.properties.description.description - schemas.Expr.properties.expression.description - schemas.Expr.properties.location.description - schemas.Expr.properties.title.description - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.consumerDefinedName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.labels.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenancePolicyNames.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenanceSchedules.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.name.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.producerMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.provisionedResources.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.slmInstanceTemplate.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.sloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.softwareVersions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.state.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.tenantProjectId.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.canReschedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.rolloutManagementPolicy.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.properties.exclude.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.properties.exclusions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.properties.nodeId.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource.properties.resourceType.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource.properties.resourceUrl.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility.properties.reason.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.duration.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.reason.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.sliName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.exclusions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.nodes.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.tier.description - schemas.ListDomainsResponse.description - schemas.ListDomainsResponse.properties.nextPageToken.description - schemas.Location.properties.displayName.description - schemas.Location.properties.labels.description - schemas.Location.properties.metadata.description - schemas.Location.properties.name.description - schemas.Operation.description - schemas.Operation.properties.done.description - schemas.Operation.properties.metadata.description - schemas.Operation.properties.name.description - schemas.Operation.properties.response.description - schemas.OperationMetadata.properties.cancelRequested.description - schemas.Policy.description - schemas.Policy.properties.bindings.description - schemas.Policy.properties.etag.description - schemas.Policy.properties.version.description - schemas.ReconfigureTrustRequest.description - schemas.ReconfigureTrustRequest.properties.targetDnsIpAddresses.description - schemas.ReconfigureTrustRequest.properties.targetDomainName.description - schemas.ResetAdminPasswordRequest.description - schemas.ResetAdminPasswordResponse.description - schemas.SetIamPolicyRequest.properties.policy.description - schemas.Status.description - schemas.Status.properties.details.description - schemas.Status.properties.message.description - schemas.TestIamPermissionsRequest.properties.permissions.description - schemas.TestIamPermissionsResponse.properties.permissions.description - schemas.Trust.description - schemas.Trust.properties.selectiveAuthentication.description - schemas.Trust.properties.targetDnsIpAddresses.description - schemas.Trust.properties.targetDomainName.description - schemas.Trust.properties.trustDirection.description - schemas.Trust.properties.trustHandshakeSecret.description - schemas.ValidateTrustRequest.description #### managedidentities:v1beta1 The following keys were added: - schemas.Domain.properties.createTime.readOnly - schemas.Domain.properties.fqdn.readOnly - schemas.Domain.properties.name.readOnly - schemas.Domain.properties.state.readOnly - schemas.Domain.properties.statusMessage.readOnly - schemas.Domain.properties.trusts.readOnly - schemas.Domain.properties.updateTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.apiVersion.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.createTime.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.endTime.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.requestedCancellation.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.target.readOnly - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.verb.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.createTime.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.producerMetadata.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.provisionedResources.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.sloMetadata.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.state.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.tenantProjectId.readOnly - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.updateTime.readOnly - schemas.Trust.properties.createTime.readOnly - schemas.Trust.properties.lastTrustHeartbeatTime.readOnly - schemas.Trust.properties.state.readOnly - schemas.Trust.properties.stateDescription.readOnly - schemas.Trust.properties.updateTime.readOnly The following keys were changed: - resources.projects.resources.locations.methods.list.parameters.includeUnrevealedLocations.description - resources.projects.resources.locations.resources.global.resources.domains.methods.attachTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.create.parameters.domainName.description - resources.projects.resources.locations.resources.global.resources.domains.methods.create.parameters.parent.description - resources.projects.resources.locations.resources.global.resources.domains.methods.delete.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.detachTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.get.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.parameters.options.requestedPolicyVersion.description - resources.projects.resources.locations.resources.global.resources.domains.methods.getIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.filter.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.orderBy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.pageToken.description - resources.projects.resources.locations.resources.global.resources.domains.methods.list.parameters.parent.description - resources.projects.resources.locations.resources.global.resources.domains.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.patch.parameters.updateMask.description - resources.projects.resources.locations.resources.global.resources.domains.methods.reconfigureTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.resetAdminPassword.parameters.name.description - resources.projects.resources.locations.resources.global.resources.domains.methods.setIamPolicy.description - resources.projects.resources.locations.resources.global.resources.domains.methods.setIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.testIamPermissions.description - resources.projects.resources.locations.resources.global.resources.domains.methods.testIamPermissions.parameters.resource.description - resources.projects.resources.locations.resources.global.resources.domains.methods.validateTrust.description - resources.projects.resources.locations.resources.global.resources.domains.methods.validateTrust.parameters.name.description - resources.projects.resources.locations.resources.global.resources.operations.methods.cancel.description - resources.projects.resources.locations.resources.global.resources.operations.methods.delete.description - resources.projects.resources.locations.resources.global.resources.operations.methods.get.description - resources.projects.resources.locations.resources.global.resources.operations.methods.list.description - schemas.AttachTrustRequest.description - schemas.Binding.properties.condition.description - schemas.Binding.properties.members.description - schemas.Binding.properties.role.description - schemas.DetachTrustRequest.description - schemas.Domain.properties.admin.description - schemas.Domain.properties.authorizedNetworks.description - schemas.Domain.properties.fqdn.description - schemas.Domain.properties.locations.description - schemas.Domain.properties.name.description - schemas.Domain.properties.reservedIpRange.description - schemas.Domain.properties.state.enumDescriptions - schemas.Domain.properties.statusMessage.description - schemas.Empty.description - schemas.Expr.description - schemas.Expr.properties.description.description - schemas.Expr.properties.expression.description - schemas.Expr.properties.location.description - schemas.Expr.properties.title.description - schemas.GoogleCloudManagedidentitiesV1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudManagedidentitiesV1alpha1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudManagedidentitiesV1beta1OpMetadata.properties.requestedCancellation.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.consumerDefinedName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.labels.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenancePolicyNames.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.maintenanceSchedules.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.name.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.producerMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.provisionedResources.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.slmInstanceTemplate.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.sloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.softwareVersions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.state.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1Instance.properties.tenantProjectId.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.canReschedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.rolloutManagementPolicy.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings.properties.exclude.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.properties.exclusions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata.properties.nodeId.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource.properties.resourceType.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource.properties.resourceUrl.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility.properties.reason.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.duration.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.reason.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.sliName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.exclusions.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.nodes.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.tier.description - schemas.ListDomainsResponse.description - schemas.ListDomainsResponse.properties.nextPageToken.description - schemas.Location.properties.displayName.description - schemas.Location.properties.labels.description - schemas.Location.properties.metadata.description - schemas.Location.properties.name.description - schemas.Operation.description - schemas.Operation.properties.done.description - schemas.Operation.properties.metadata.description - schemas.Operation.properties.name.description - schemas.Operation.properties.response.description - schemas.OperationMetadata.properties.cancelRequested.description - schemas.Policy.description - schemas.Policy.properties.bindings.description - schemas.Policy.properties.etag.description - schemas.Policy.properties.version.description - schemas.ReconfigureTrustRequest.description - schemas.ReconfigureTrustRequest.properties.targetDnsIpAddresses.description - schemas.ReconfigureTrustRequest.properties.targetDomainName.description - schemas.ResetAdminPasswordRequest.description - schemas.ResetAdminPasswordResponse.description - schemas.SetIamPolicyRequest.properties.policy.description - schemas.Status.description - schemas.Status.properties.details.description - schemas.Status.properties.message.description - schemas.TestIamPermissionsRequest.properties.permissions.description - schemas.TestIamPermissionsResponse.properties.permissions.description - schemas.Trust.description - schemas.Trust.properties.lastTrustHeartbeatTime.description - schemas.Trust.properties.selectiveAuthentication.description - schemas.Trust.properties.stateDescription.description - schemas.Trust.properties.targetDnsIpAddresses.description - schemas.Trust.properties.targetDomainName.description - schemas.Trust.properties.trustDirection.description - schemas.Trust.properties.trustHandshakeSecret.description - schemas.ValidateTrustRequest.description --- discovery/managedidentities-v1.json | 270 ++++++++++++--------- discovery/managedidentities-v1alpha1.json | 261 ++++++++++---------- discovery/managedidentities-v1beta1.json | 275 ++++++++++++---------- src/apis/managedidentities/v1.ts | 147 ++++-------- src/apis/managedidentities/v1alpha1.ts | 156 +++++------- src/apis/managedidentities/v1beta1.ts | 147 ++++-------- 6 files changed, 603 insertions(+), 653 deletions(-) diff --git a/discovery/managedidentities-v1.json b/discovery/managedidentities-v1.json index 84622c536c4..e48a0417d54 100644 --- a/discovery/managedidentities-v1.json +++ b/discovery/managedidentities-v1.json @@ -149,7 +149,7 @@ "type": "string" }, "includeUnrevealedLocations": { - "description": "If true, the returned list will include locations which are not yet\nrevealed.", + "description": "If true, the returned list will include locations which are not yet revealed.", "location": "query", "type": "boolean" }, @@ -196,7 +196,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -224,12 +224,12 @@ ], "parameters": { "domainName": { - "description": "Required. The fully qualified domain name.\ne.g. mydomain.myorganization.com, with the following restrictions:\n\n * Must contain only lowercase letters, numbers, periods and hyphens.\n * Must start with a letter.\n * Must contain between 2-64 characters.\n * Must end with a number or a letter.\n * Must not start with period.\n * First segement length (mydomain form example above) shouldn't exceed\n 15 chars.\n * The last segment cannot be fully numeric.\n * Must be unique within the customer project.", + "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 segement length (mydomain form 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" }, "parent": { - "description": "Required. The resource project name and location using the form:\n`projects/{project_id}/locations/global`", + "description": "Required. The resource project name and location using the form: `projects/{project_id}/locations/global`", "location": "path", "pattern": "^projects/[^/]+/locations/global$", "required": true, @@ -257,7 +257,7 @@ ], "parameters": { "name": { - "description": "Required. The domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -282,7 +282,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name, and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -310,7 +310,7 @@ ], "parameters": { "name": { - "description": "Required. The domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -326,7 +326,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a resource.\nReturns an empty policy if the resource exists and does not have a policy\nset.", + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:getIamPolicy", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.domains.getIamPolicy", @@ -335,13 +335,13 @@ ], "parameters": { "options.requestedPolicyVersion": { - "description": "Optional. The policy format version to be returned.\n\nValid values are 0, 1, and 3. Requests specifying an invalid value will be\nrejected.\n\nRequests for policies with any conditional bindings must specify version 3.\nPolicies without any conditional bindings may specify any valid value or\nleave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "description": "Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "location": "query", "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -366,28 +366,28 @@ ], "parameters": { "filter": { - "description": "Optional. A filter specifying constraints of a list operation.\nFor example, `Domain.fqdn=\"mydomain.myorginization\"`.", + "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\n[Sorting\norder](https://cloud.google.com/apis/design/design_patterns#sorting_order)\nfor more information.", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return.\nIf not specified, a default value of 1000 will be used.\nRegardless of the page_size value, the response may include a partial list.\nCallers should rely on a response's\nnext_page_token\nto determine if there are additional results to list.", + "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.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. The `next_page_token` value returned from a previous ListDomainsRequest\nrequest, if any.", + "description": "Optional. The `next_page_token` value returned from a previous ListDomainsRequest request, if any.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The resource name of the domain location using the form:\n`projects/{project_id}/locations/global`", + "description": "Required. The resource name of the domain location using the form: `projects/{project_id}/locations/global`", "location": "path", "pattern": "^projects/[^/]+/locations/global$", "required": true, @@ -412,14 +412,14 @@ ], "parameters": { "name": { - "description": "Required. The unique name of the domain using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`.", + "description": "Required. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Required. Mask of fields to update. At least one path must be supplied in this\nfield. The elements of the repeated paths field may only include\nfields from Domain:\n * `labels`\n * `locations`\n * `authorized_networks`", + "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`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -446,7 +446,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -474,7 +474,7 @@ ], "parameters": { "name": { - "description": "Required. The domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -493,7 +493,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any\nexisting policy.\n\nCan return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:setIamPolicy", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.setIamPolicy", @@ -502,7 +502,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -521,7 +521,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that a caller has on the specified resource.\nIf the resource does not exist, this will return an empty set of\npermissions, not a `NOT_FOUND` error.\n\nNote: This operation is designed to be used for building permission-aware\nUIs and command-line tools, not for authorization checking. This operation\nmay \"fail open\" without warning.", + "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.", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:testIamPermissions", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.testIamPermissions", @@ -530,7 +530,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -549,7 +549,7 @@ ] }, "validateTrust": { - "description": "Validates a trust state, that the target domain is reachable, and that the\ntarget domain is able to accept incoming trust requests.", + "description": "Validates a trust state, that the target domain is reachable, and that the target domain is able to accept incoming trust requests.", "flatPath": "v1/projects/{projectsId}/locations/global/domains/{domainsId}:validateTrust", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.validateTrust", @@ -558,7 +558,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name, and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -581,7 +581,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "flatPath": "v1/projects/{projectsId}/locations/global/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.operations.cancel", @@ -609,7 +609,7 @@ ] }, "delete": { - "description": "Deletes a long-running operation. This method indicates that the client is\nno longer interested in the operation result. It does not cancel the\noperation. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.", + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "DELETE", "id": "managedidentities.projects.locations.global.operations.delete", @@ -634,7 +634,7 @@ ] }, "get": { - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.", + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.operations.get", @@ -659,7 +659,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.", + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", "flatPath": "v1/projects/{projectsId}/locations/global/operations", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.operations.list", @@ -708,11 +708,11 @@ } } }, - "revision": "20200707", + "revision": "20200727", "rootUrl": "https://managedidentities.googleapis.com/", "schemas": { "AttachTrustRequest": { - "description": "Request message for\nAttachTrust", + "description": "Request message for AttachTrust", "id": "AttachTrustRequest", "properties": { "trust": { @@ -728,17 +728,17 @@ "properties": { "condition": { "$ref": "Expr", - "description": "The condition that is associated with this binding.\n\nIf the condition evaluates to `true`, then this binding applies to the\ncurrent request.\n\nIf the condition evaluates to `false`, then this binding does not apply to\nthe current request. However, a different role binding might grant the same\nrole to one or more of the members in this binding.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies)." + "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 members 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)." }, "members": { - "description": "Specifies the identities requesting access for a Cloud Platform resource.\n`members` can have the following values:\n\n* `allUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special identifier that represents anyone\n who is authenticated with a Google account or a service account.\n\n* `user:{emailid}`: An email address that represents a specific Google\n account. For example, `alice@example.com` .\n\n\n* `serviceAccount:{emailid}`: An email address that represents a service\n account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{emailid}`: An email address that represents a Google group.\n For example, `admins@example.com`.\n\n* `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a user that has been recently deleted. For\n example, `alice@example.com?uid=123456789012345678901`. If the user is\n recovered, this value reverts to `user:{emailid}` and the recovered user\n retains the role in the binding.\n\n* `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus\n unique identifier) representing a service account that has been recently\n deleted. For example,\n `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.\n If the service account is undeleted, this value reverts to\n `serviceAccount:{emailid}` and the undeleted service account retains the\n role in the binding.\n\n* `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a Google group that has been recently\n deleted. For example, `admins@example.com?uid=123456789012345678901`. If\n the group is recovered, this value reverts to `group:{emailid}` and the\n recovered group retains the role in the binding.\n\n\n* `domain:{domain}`: The G Suite domain (primary) that represents all the\n users of that domain. For example, `google.com` or `example.com`.\n\n", + "description": "Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, "type": "array" }, "role": { - "description": "Role that is assigned to `members`.\nFor example, `roles/viewer`, `roles/editor`, or `roles/owner`.", + "description": "Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.", "type": "string" } }, @@ -751,7 +751,7 @@ "type": "object" }, "DetachTrustRequest": { - "description": "Request message for\nDetachTrust", + "description": "Request message for DetachTrust", "id": "DetachTrustRequest", "properties": { "trust": { @@ -766,11 +766,11 @@ "id": "Domain", "properties": { "admin": { - "description": "Optional. The name of delegated administrator account used to perform\nActive Directory operations. If not specified, `setupadmin` will be used.", + "description": "Optional. The name of delegated administrator account used to perform Active Directory operations. If not specified, `setupadmin` will be used.", "type": "string" }, "authorizedNetworks": { - "description": "Optional. The full names of the Google Compute Engine\n[networks](/compute/docs/networks-and-firewalls#networks) the domain\ninstance is connected to. Networks can be added using UpdateDomain.\nThe domain is only available on networks listed in `authorized_networks`.\nIf CIDR subnets overlap between networks, domain creation will fail.", + "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.", "items": { "type": "string" }, @@ -779,10 +779,12 @@ "createTime": { "description": "Output only. The time the instance was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "fqdn": { - "description": "Output only. The fully-qualified domain name of the exposed domain used by\nclients to connect to the service. Similar to what would be chosen for an\nActive Directory set up on an internal network.", + "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" }, "labels": { @@ -793,18 +795,18 @@ "type": "object" }, "locations": { - "description": "Required. Locations where domain needs to be provisioned.\nregions\ne.g. us-west1 or us-east4\nService supports up to 4 locations at once. Each location will use a /26\nblock.", + "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.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "Required. The unique name of the domain using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`.", + "description": "Required. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", "type": "string" }, "reservedIpRange": { - "description": "Required. The CIDR range of internal addresses that are reserved for this\ndomain. Reserved networks must be /24 or larger. Ranges must be\nunique and non-overlapping with existing subnets in\n[Domain].[authorized_networks].", + "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" }, "state": { @@ -825,14 +827,16 @@ "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\ncan be found in the `status_message` field.", + "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." ], + "readOnly": true, "type": "string" }, "statusMessage": { - "description": "Output only. Additional information about the current status of this\ndomain, if available.", + "description": "Output only. Additional information about the current status of this domain, if available.", + "readOnly": true, "type": "string" }, "trusts": { @@ -840,40 +844,42 @@ "items": { "$ref": "Trust" }, + "readOnly": true, "type": "array" }, "updateTime": { "description": "Output only. The last update time.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "Empty": { - "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.", "id": "Empty", "properties": {}, "type": "object" }, "Expr": { - "description": "Represents a textual expression in the Common Expression Language (CEL)\nsyntax. CEL is a C-like expression language. The syntax and semantics of CEL\nare documented at https://github.com/google/cel-spec.\n\nExample (Comparison):\n\n title: \"Summary size limit\"\n description: \"Determines if a summary is less than 100 chars\"\n expression: \"document.summary.size() < 100\"\n\nExample (Equality):\n\n title: \"Requestor is owner\"\n description: \"Determines if requestor is the document owner\"\n expression: \"document.owner == request.auth.claims.email\"\n\nExample (Logic):\n\n title: \"Public documents\"\n description: \"Determine whether the document should be publicly visible\"\n expression: \"document.type != 'private' && document.type != 'internal'\"\n\nExample (Data Manipulation):\n\n title: \"Notification string\"\n description: \"Create a notification string with a timestamp.\"\n expression: \"'New message received at ' + string(document.create_time)\"\n\nThe exact variables and functions that may be referenced within an expression\nare determined by the service that evaluates it. See the service\ndocumentation for additional information.", + "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() < 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.", "id": "Expr", "properties": { "description": { - "description": "Optional. Description of the expression. This is a longer text which\ndescribes the expression, e.g. when hovered over it in a UI.", + "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" }, "expression": { - "description": "Textual representation of an expression in Common Expression Language\nsyntax.", + "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "location": { - "description": "Optional. String indicating the location of the expression for error\nreporting, e.g. a file name and a position in the file.", + "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" }, "title": { - "description": "Optional. Title for the expression, i.e. a short string describing\nits purpose. This can be used e.g. in UIs which allow to enter the\nexpression.", + "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" } }, @@ -885,28 +891,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -918,28 +930,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -951,28 +969,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -982,33 +1006,34 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", "properties": { "consumerDefinedName": { - "description": "consumer_defined_name is the name that is set by the consumer. On the other\nhand Name field represents system-assigned id of an instance so consumers\nare not necessarily aware of it.\nconsumer_defined_name is used for notification/UI purposes for consumer to\nrecognize their instances.", + "description": "consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when the resource was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Resource labels to represent user provided metadata. Each label\nis a key-value pair, where both the key and the value are arbitrary strings\nprovided by the user.", + "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" }, "maintenancePolicyNames": { "additionalProperties": { "type": "string" }, - "description": "The MaintenancePolicies that have been attached to the instance.\nThe key must be of the type name of the oneof policy name defined in\nMaintenancePolicy, and the referenced policy must define the same policy\ntype. For complete details of MaintenancePolicy, please refer to\ngo/cloud-saas-mw-ug.", + "description": "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 complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.", "type": "object" }, "maintenanceSchedules": { "additionalProperties": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule" }, - "description": "The MaintenanceSchedule contains the scheduling information of published\nmaintenance schedule.", + "description": "The MaintenanceSchedule contains the scheduling information of published maintenance schedule.", "type": "object" }, "maintenanceSettings": { @@ -1016,40 +1041,43 @@ "description": "Optional. The MaintenanceSettings associated with instance." }, "name": { - "description": "Unique name of the resource. It uses the form:\n `projects/{project_id}/locations/{location_id}/instances/{instance_id}`", + "description": "Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}`", "type": "string" }, "producerMetadata": { "additionalProperties": { "type": "string" }, - "description": "Output only. Custom string attributes used primarily to expose\nproducer-specific information in monitoring dashboards.\nSee go/get-instance-metadata.", + "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" }, "provisionedResources": { - "description": "Output only. The list of data plane resources provisioned for this\ninstance, e.g. compute VMs. See go/get-instance-metadata.", + "description": "Output only. The list of data plane resources provisioned for this instance, e.g. compute VMs. See go/get-instance-metadata.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource" }, + "readOnly": true, "type": "array" }, "slmInstanceTemplate": { - "description": "Link to the SLM instance template. Only populated when updating SLM\ninstances via SSA's Actuation service adaptor.\nService producers with custom control plane (e.g. Cloud SQL) doesn't\nneed to populate this field. Instead they should use software_versions.", + "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" }, "sloMetadata": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata", - "description": "Output only. SLO metadata for instance classification in the\nStandardized dataplane SLO platform.\nSee go/cloud-ssa-standard-slo for feature description." + "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 }, "softwareVersions": { "additionalProperties": { "type": "string" }, - "description": "Software versions that are used to deploy this instance. This can be\nmutated by rollout services.", + "description": "Software versions that are used to deploy this instance. This can be mutated by rollout services.", "type": "object" }, "state": { - "description": "Output only. Current lifecycle state of the resource (e.g. if it's being\ncreated or ready to use).", + "description": "Output only. Current lifecycle state of the resource (e.g. if it's being created or ready to use).", "enum": [ "STATE_UNSPECIFIED", "CREATING", @@ -1068,26 +1096,29 @@ "Instance is being deleted.", "Instance encountered an error and is in indeterministic state." ], + "readOnly": true, "type": "string" }, "tenantProjectId": { - "description": "Output only. ID of the associated GCP tenant project.\nSee go/get-instance-metadata.", + "description": "Output only. ID of the associated GCP tenant project. See go/get-instance-metadata.", + "readOnly": true, "type": "string" }, "updateTime": { "description": "Output only. Timestamp when the resource was last modified.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule": { - "description": "Maintenance schedule which is exposed to customer and potentially end user,\nindicating published upcoming future maintenance schedule", + "description": "Maintenance schedule which is exposed to customer and potentially end user, indicating published upcoming future maintenance schedule", "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule", "properties": { "canReschedule": { - "description": "Can this scheduled update be rescheduled?\nBy default, it's true and API needs to do explicitly check whether it's\nset, if it's set as false explicitly, it's false", + "description": "Can this scheduled update be rescheduled? By default, it's true and API needs to do explicitly check whether it's set, if it's set as false explicitly, it's false", "type": "boolean" }, "endTime": { @@ -1096,7 +1127,7 @@ "type": "string" }, "rolloutManagementPolicy": { - "description": "The rollout management policy this maintenance schedule is associated\nwith. When doing reschedule update request, the reschedule should be\nagainst this given policy.", + "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" }, "startTime": { @@ -1108,22 +1139,22 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings": { - "description": "Maintenance settings associated with instance. Allows service producers and\nend users to assign settings that controls maintenance on this instance.", + "description": "Maintenance settings associated with instance. Allows service producers and end users to assign settings that controls maintenance on this instance.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings", "properties": { "exclude": { - "description": "Optional. Exclude instance from maintenance. When true, rollout service will not\nattempt maintenance on the instance. Rollout service will include the\ninstance in reported rollout progress as not attempted.", + "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" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata": { - "description": "Node information for custom per-node SLO implementations.\nSSA does not support per-node SLO, but producers can populate per-node\ninformation in SloMetadata for custom precomputations.\nSSA Eligibility Exporter will emit per-node metric based on this information.", + "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.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata", "properties": { "exclusions": { - "description": "By default node is eligible if instance is eligible.\nBut individual node might be excluded from SLO by adding entry here.\nFor semantic see SloMetadata.exclusions.\nIf both instance and node level exclusions are present for time period,\nthe node level's reason will be reported by Eligibility Exporter.", + "description": "By default node is eligible if instance is eligible. But individual node might be excluded from SLO by adding entry here. For semantic see SloMetadata.exclusions. If both instance and node level exclusions are present for time period, the node level's reason will be reported by Eligibility Exporter.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion" }, @@ -1134,7 +1165,7 @@ "type": "string" }, "nodeId": { - "description": "The id of the node.\nThis should be equal to SaasInstanceNode.node_id.", + "description": "The id of the node. This should be equal to SaasInstanceNode.node_id.", "type": "string" } }, @@ -1145,18 +1176,18 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource", "properties": { "resourceType": { - "description": "Type of the resource. This can be either a GCP resource or a custom one\n(e.g. another cloud provider's VM). For GCP compute resources use singular\nform of the names listed in GCP compute API documentation\n(https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with\n'compute-', for example: 'compute-instance', 'compute-disk',\n'compute-autoscaler'.", + "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.\n\"https://www.googleapis.com/compute/v1/projects/...)\".", + "description": "URL identifying the resource, e.g. \"https://www.googleapis.com/compute/v1/projects/...)\".", "type": "string" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility": { - "description": "SloEligibility is a tuple containing eligibility value: true if an instance\nis eligible for SLO calculation or false if it should be excluded from all\nSLO-related calculations along with a user-defined reason.", + "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.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility", "properties": { "eligible": { @@ -1164,7 +1195,7 @@ "type": "boolean" }, "reason": { - "description": "User-defined reason for the current value of instance eligibility. Usually,\nthis can be directly mapped to the internal state. An empty reason is\nallowed.", + "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" } }, @@ -1175,16 +1206,16 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion", "properties": { "duration": { - "description": "Exclusion duration. No restrictions on the possible values.\n\nWhen an ongoing operation is taking longer than initially expected,\nan existing entry in the exclusion list can be updated by extending the\nduration. This is supported by the subsystem exporting eligibility data\nas long as such extension is committed at least 10 minutes before the\noriginal exclusion expiration - otherwise it is possible that there will\nbe \"gaps\" in the exclusion application in the exported timeseries.", + "description": "Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be \"gaps\" in the exclusion application in the exported timeseries.", "format": "google-duration", "type": "string" }, "reason": { - "description": "Human-readable reason for the exclusion.\nThis should be a static string (e.g. \"Disruptive update in progress\")\nand should not contain dynamically generated data (e.g. instance name).\nCan be left empty.", + "description": "Human-readable reason for the exclusion. This should be a static string (e.g. \"Disruptive update in progress\") and should not contain dynamically generated data (e.g. instance name). Can be left empty.", "type": "string" }, "sliName": { - "description": "Name of an SLI that this exclusion applies to. Can be left empty,\nsignaling that the instance should be excluded from all SLIs defined\nin the service SLO configuration.", + "description": "Name of an SLI that this exclusion applies to. Can be left empty, signaling that the instance should be excluded from all SLIs defined in the service SLO configuration.", "type": "string" }, "startTime": { @@ -1196,7 +1227,7 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata": { - "description": "SloMetadata contains resources required for proper SLO classification of the\ninstance.", + "description": "SloMetadata contains resources required for proper SLO classification of the instance.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata", "properties": { "eligibility": { @@ -1204,28 +1235,28 @@ "description": "Optional. User-defined instance eligibility." }, "exclusions": { - "description": "List of SLO exclusion windows. When multiple entries in the list match\n(matching the exclusion time-window against current time point)\nthe exclusion reason used in the first matching entry will be published.\n\nIt is not needed to include expired exclusion in this list, as only the\ncurrently applicable exclusions are taken into account by the eligibility\nexporting subsystem (the historical state of exclusions will be reflected\nin the historically produced timeseries regardless of the current state).\n\nThis field can be used to mark the instance as temporary ineligible\nfor the purpose of SLO calculation. For permanent instance SLO exclusion,\nuse of custom instance eligibility is recommended. See 'eligibility' field\nbelow.", + "description": "List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion" }, "type": "array" }, "nodes": { - "description": "Optional. List of nodes.\nSome producers need to use per-node metadata to calculate SLO.\nThis field allows such producers to publish per-node SLO meta data,\nwhich will be consumed by SSA Eligibility Exporter and published in the\nform of per node metric to Monarch.", + "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.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata" }, "type": "array" }, "tier": { - "description": "Name of the SLO tier the Instance belongs to. This name will be expected to\nmatch the tiers specified in the service SLO configuration.\n\nField is mandatory and must not be empty.", + "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" } }, "type": "object" }, "ListDomainsResponse": { - "description": "Response message for\nListDomains", + "description": "Response message for ListDomains", "id": "ListDomainsResponse", "properties": { "domains": { @@ -1236,7 +1267,7 @@ "type": "array" }, "nextPageToken": { - "description": "A token to retrieve the next page of results, or empty if there are no more\nresults in the list.", + "description": "A token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { @@ -1290,14 +1321,14 @@ "id": "Location", "properties": { "displayName": { - "description": "The friendly name for this location, typically a nearby city name.\nFor example, \"Tokyo\".", + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Cross-service attributes for the location. For example\n\n {\"cloud.googleapis.com/region\": \"us-east1\"}", + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object" }, "locationId": { @@ -1309,22 +1340,22 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata. For example the available capacity at the given\nlocation.", + "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object" }, "name": { - "description": "Resource name for the location, which may vary between implementations.\nFor example: `\"projects/example-project/locations/us-east1\"`", + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" } }, "type": "object" }, "Operation": { - "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", + "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", "properties": { "done": { - "description": "If the value is `false`, it means the operation is still in progress.\nIf `true`, the operation is completed, and either `error` or `response` is\navailable.", + "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": { @@ -1336,11 +1367,11 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata associated with the operation. It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata. Any method that returns a\nlong-running operation should document the metadata type, if any.", + "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" }, "name": { - "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should be a resource name ending with `operations/{unique_id}`.", + "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" }, "response": { @@ -1348,7 +1379,7 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.", + "description": "The normal response of the operation in case of success. 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" } }, @@ -1363,7 +1394,7 @@ "type": "string" }, "cancelRequested": { - "description": "[Output only] Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "type": "boolean" }, "createTime": { @@ -1392,23 +1423,23 @@ "type": "object" }, "Policy": { - "description": "An Identity and Access Management (IAM) policy, which specifies access\ncontrols for Google Cloud resources.\n\n\nA `Policy` is a collection of `bindings`. A `binding` binds one or more\n`members` to a single `role`. Members can be user accounts, service accounts,\nGoogle groups, and domains (such as G Suite). A `role` is a named list of\npermissions; each `role` can be an IAM predefined role or a user-created\ncustom role.\n\nFor some types of Google Cloud resources, a `binding` can also specify a\n`condition`, which is a logical expression that allows access to a resource\nonly if the expression evaluates to `true`. A condition can add constraints\nbased on attributes of the request, the resource, or both. To learn which\nresources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).\n\n**JSON example:**\n\n {\n \"bindings\": [\n {\n \"role\": \"roles/resourcemanager.organizationAdmin\",\n \"members\": [\n \"user:mike@example.com\",\n \"group:admins@example.com\",\n \"domain:google.com\",\n \"serviceAccount:my-project-id@appspot.gserviceaccount.com\"\n ]\n },\n {\n \"role\": \"roles/resourcemanager.organizationViewer\",\n \"members\": [\n \"user:eve@example.com\"\n ],\n \"condition\": {\n \"title\": \"expirable access\",\n \"description\": \"Does not grant access after Sep 2020\",\n \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\",\n }\n }\n ],\n \"etag\": \"BwWWja0YfJA=\",\n \"version\": 3\n }\n\n**YAML example:**\n\n bindings:\n - members:\n - user:mike@example.com\n - group:admins@example.com\n - domain:google.com\n - serviceAccount:my-project-id@appspot.gserviceaccount.com\n role: roles/resourcemanager.organizationAdmin\n - members:\n - user:eve@example.com\n role: roles/resourcemanager.organizationViewer\n condition:\n title: expirable access\n description: Does not grant access after Sep 2020\n expression: request.time < timestamp('2020-10-01T00:00:00.000Z')\n - etag: BwWWja0YfJA=\n - version: 3\n\nFor a description of IAM and its features, see the\n[IAM documentation](https://cloud.google.com/iam/docs/).", + "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` to a single `role`. Members 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 < 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 < 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/).", "id": "Policy", "properties": { "bindings": { - "description": "Associates a list of `members` to a `role`. Optionally, may specify a\n`condition` that determines how and when the `bindings` are applied. Each\nof the `bindings` must contain at least one member.", + "description": "Associates a list of `members` to 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 member.", "items": { "$ref": "Binding" }, "type": "array" }, "etag": { - "description": "`etag` is used for optimistic concurrency control as a way to help\nprevent simultaneous updates of a policy from overwriting each other.\nIt is strongly suggested that systems make use of the `etag` in the\nread-modify-write cycle to perform policy updates in order to avoid race\nconditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems are expected to put that etag in the request to `setIamPolicy` to\nensure that their change will be applied to the same version of the policy.\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.", + "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.", "format": "byte", "type": "string" }, "version": { - "description": "Specifies the format of the policy.\n\nValid values are `0`, `1`, and `3`. Requests that specify an invalid value\nare rejected.\n\nAny operation that affects conditional role bindings must specify version\n`3`. This requirement applies to the following operations:\n\n* Getting a policy that includes a conditional role binding\n* Adding a conditional role binding to a policy\n* Changing a conditional role binding in a policy\n* Removing any role binding, with or without a condition, from a policy\n that includes conditions\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.\n\nIf a policy does not include any conditions, operations on that policy may\nspecify any valid version or leave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "type": "integer" } @@ -1416,31 +1447,31 @@ "type": "object" }, "ReconfigureTrustRequest": { - "description": "Request message for\nReconfigureTrust", + "description": "Request message for ReconfigureTrust", "id": "ReconfigureTrustRequest", "properties": { "targetDnsIpAddresses": { - "description": "Required. The target DNS server IP addresses to resolve the remote domain involved\nin the trust.", + "description": "Required. The target DNS server IP addresses to resolve the remote domain involved in the trust.", "items": { "type": "string" }, "type": "array" }, "targetDomainName": { - "description": "Required. The fully-qualified target domain name which will be in trust with current\ndomain.", + "description": "Required. The fully-qualified target domain name which will be in trust with current domain.", "type": "string" } }, "type": "object" }, "ResetAdminPasswordRequest": { - "description": "Request message for\nResetAdminPassword", + "description": "Request message for ResetAdminPassword", "id": "ResetAdminPasswordRequest", "properties": {}, "type": "object" }, "ResetAdminPasswordResponse": { - "description": "Response message for\nResetAdminPassword", + "description": "Response message for ResetAdminPassword", "id": "ResetAdminPasswordResponse", "properties": { "password": { @@ -1456,13 +1487,13 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An empty policy is a\nvalid policy but certain Cloud Platform services (such as Projects)\nmight reject them." + "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 Cloud Platform services (such as Projects) might reject them." } }, "type": "object" }, "Status": { - "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", + "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).", "id": "Status", "properties": { "code": { @@ -1471,7 +1502,7 @@ "type": "integer" }, "details": { - "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", @@ -1482,7 +1513,7 @@ "type": "array" }, "message": { - "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", + "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" } }, @@ -1493,7 +1524,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with\nwildcards (such as '*' or 'storage.*') are not allowed. For more\ninformation see\n[IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, @@ -1507,7 +1538,7 @@ "id": "TestIamPermissionsResponse", "properties": { "permissions": { - "description": "A subset of `TestPermissionsRequest.permissions` that the caller is\nallowed.", + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "items": { "type": "string" }, @@ -1517,21 +1548,23 @@ "type": "object" }, "Trust": { - "description": "Represents a relationship between two domains. This allows a controller in\none domain to authenticate a user in another domain.", + "description": "Represents a relationship between two domains. This allows a controller in one domain to authenticate a user in another domain.", "id": "Trust", "properties": { "createTime": { "description": "Output only. The time the instance was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "lastTrustHeartbeatTime": { "description": "Output only. The last heartbeat time when the trust was known to be connected.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "selectiveAuthentication": { - "description": "Optional. The trust authentication type, which decides whether the trusted side has\nforest/domain wide access or selective access to an approved set of\nresources.", + "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" }, "state": { @@ -1552,25 +1585,27 @@ "The domain trust is connected.", "The domain trust is disconnected." ], + "readOnly": true, "type": "string" }, "stateDescription": { "description": "Output only. Additional information about the current state of the trust, if available.", + "readOnly": true, "type": "string" }, "targetDnsIpAddresses": { - "description": "Required. The target DNS server IP addresses which can resolve the remote domain\ninvolved in the trust.", + "description": "Required. The target DNS server IP addresses which can resolve the remote domain involved in the trust.", "items": { "type": "string" }, "type": "array" }, "targetDomainName": { - "description": "Required. The fully qualified target domain name which will be in trust with the\ncurrent domain.", + "description": "Required. The fully qualified target domain name which will be in trust with the current domain.", "type": "string" }, "trustDirection": { - "description": "Required. The trust direction, which decides if the current domain is trusted,\ntrusting, or both.", + "description": "Required. The trust direction, which decides if the current domain is trusted, trusting, or both.", "enum": [ "TRUST_DIRECTION_UNSPECIFIED", "INBOUND", @@ -1586,7 +1621,7 @@ "type": "string" }, "trustHandshakeSecret": { - "description": "Required. The trust secret used for the handshake with the target domain. This will\nnot be stored.", + "description": "Required. The trust secret used for the handshake with the target domain. This will not be stored.", "type": "string" }, "trustType": { @@ -1606,13 +1641,14 @@ "updateTime": { "description": "Output only. The last update time.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "ValidateTrustRequest": { - "description": "Request message for\nValidateTrust", + "description": "Request message for ValidateTrust", "id": "ValidateTrustRequest", "properties": { "trust": { diff --git a/discovery/managedidentities-v1alpha1.json b/discovery/managedidentities-v1alpha1.json index 202e9665020..afbfd630863 100644 --- a/discovery/managedidentities-v1alpha1.json +++ b/discovery/managedidentities-v1alpha1.json @@ -149,7 +149,7 @@ "type": "string" }, "includeUnrevealedLocations": { - "description": "If true, the returned list will include locations which are not yet\nrevealed.", + "description": "If true, the returned list will include locations which are not yet revealed.", "location": "query", "type": "boolean" }, @@ -187,7 +187,7 @@ "domains": { "methods": { "attachTrust": { - "description": "Adds AD trust in a given domain.\nOperation", + "description": "Adds AD trust in a given domain. Operation", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:attachTrust", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.attachTrust", @@ -196,7 +196,7 @@ ], "parameters": { "name": { - "description": "The resource domain name, project name and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -215,7 +215,7 @@ ] }, "create": { - "description": "Creates a Microsoft AD Domain in a given project.\nOperation", + "description": "Creates a Microsoft AD Domain in a given project. Operation", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.create", @@ -224,12 +224,12 @@ ], "parameters": { "domainName": { - "description": "The fully qualified domain name.\ne.g. mydomain.myorganization.com, with the following restrictions:\n\n * Must contain only lowercase letters, numbers, periods and hyphens.\n * Must start with a letter.\n * Must contain between 2-64 characters.\n * Must end with a number or a letter.\n * Must not start with period.\n * Must be unique within the project.\n * First segement length (mydomain form example above) shouldn't exceed\n 15 chars.\n * The last segment cannot be fully numeric.", + "description": "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. * Must be unique within the project. * First segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric.", "location": "query", "type": "string" }, "parent": { - "description": "Resource project name and location using the form:\n`projects/{project_id}/locations/global`", + "description": "Resource project name and location using the form: `projects/{project_id}/locations/global`", "location": "path", "pattern": "^projects/[^/]+/locations/global$", "required": true, @@ -248,7 +248,7 @@ ] }, "delete": { - "description": "Deletes identified domain.\nOperation", + "description": "Deletes identified domain. Operation", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}", "httpMethod": "DELETE", "id": "managedidentities.projects.locations.global.domains.delete", @@ -257,7 +257,7 @@ ], "parameters": { "name": { - "description": "Domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -273,7 +273,7 @@ ] }, "detachTrust": { - "description": "Removes identified trust.\nOperation", + "description": "Removes identified trust. Operation", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:detachTrust", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.detachTrust", @@ -282,7 +282,7 @@ ], "parameters": { "name": { - "description": "The resource domain name, project name, and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -310,7 +310,7 @@ ], "parameters": { "name": { - "description": "Domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -326,7 +326,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a resource.\nReturns an empty policy if the resource exists and does not have a policy\nset.", + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:getIamPolicy", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.domains.getIamPolicy", @@ -335,13 +335,13 @@ ], "parameters": { "options.requestedPolicyVersion": { - "description": "Optional. The policy format version to be returned.\n\nValid values are 0, 1, and 3. Requests specifying an invalid value will be\nrejected.\n\nRequests for policies with any conditional bindings must specify version 3.\nPolicies without any conditional bindings may specify any valid value or\nleave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "description": "Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "location": "query", "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -366,17 +366,17 @@ ], "parameters": { "filter": { - "description": "Optional. Filter specifying constraints of a list operation.\nFor example, `Domain.fqdn=\"mydomain.myorginization\"`.", + "description": "Optional. 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 following syntax at\nhttps://cloud.google.com/apis/design/design_patterns#sorting_order.", + "description": "Optional. Specifies the ordering of results following syntax at https://cloud.google.com/apis/design/design_patterns#sorting_order.", "location": "query", "type": "string" }, "pageSize": { - "description": "If not specified, a default value of 1000 will be used by the service.\nRegardless of the page_size value, the response may include a partial list\nand a caller should only rely on response's\nnext_page_token\nto determine if there are more instances left to be queried.", + "description": "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.", "format": "int32", "location": "query", "type": "integer" @@ -387,7 +387,7 @@ "type": "string" }, "parent": { - "description": "Required. The resource name of the domain location using the form:\n`projects/{project_id}/locations/global`", + "description": "Required. The resource name of the domain location using the form: `projects/{project_id}/locations/global`", "location": "path", "pattern": "^projects/[^/]+/locations/global$", "required": true, @@ -403,7 +403,7 @@ ] }, "patch": { - "description": "Updates the metadata and configuration of a specified domain.\nOperation", + "description": "Updates the metadata and configuration of a specified domain. Operation", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}", "httpMethod": "PATCH", "id": "managedidentities.projects.locations.global.domains.patch", @@ -412,14 +412,14 @@ ], "parameters": { "name": { - "description": "Output only. Unique name of the domain in this scope including projects and\nlocation using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`.", + "description": "Output only. Unique name of the domain in this scope including projects and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Mask of fields to update. At least one path must be supplied in this\nfield. The elements of the repeated paths field may only include these\nfields from Domain:\n * `labels`\n * `locations`\n * `authorized_networks`", + "description": "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 Domain: * `labels` * `locations` * `authorized_networks`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -437,7 +437,7 @@ ] }, "reconfigureTrust": { - "description": "Updates the dns conditional forwarder.\nOperation", + "description": "Updates the dns conditional forwarder. Operation", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:reconfigureTrust", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.reconfigureTrust", @@ -446,7 +446,7 @@ ], "parameters": { "name": { - "description": "The resource domain name, project name and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -465,7 +465,7 @@ ] }, "resetAdminPassword": { - "description": "Resets managed identities admin password identified by\nmanaged_identities_admin_name", + "description": "Resets managed identities admin password identified by managed_identities_admin_name", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:resetAdminPassword", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.resetAdminPassword", @@ -474,7 +474,7 @@ ], "parameters": { "name": { - "description": "The domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -493,7 +493,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any\nexisting policy.\n\nCan return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:setIamPolicy", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.setIamPolicy", @@ -502,7 +502,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -521,7 +521,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that a caller has on the specified resource.\nIf the resource does not exist, this will return an empty set of\npermissions, not a `NOT_FOUND` error.\n\nNote: This operation is designed to be used for building permission-aware\nUIs and command-line tools, not for authorization checking. This operation\nmay \"fail open\" without warning.", + "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.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:testIamPermissions", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.testIamPermissions", @@ -530,7 +530,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -549,7 +549,7 @@ ] }, "validateTrust": { - "description": "Validate the trust state\nOperation", + "description": "Validate the trust state Operation", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/domains/{domainsId}:validateTrust", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.validateTrust", @@ -558,7 +558,7 @@ ], "parameters": { "name": { - "description": "The resource domain name, project name, and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -581,7 +581,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.operations.cancel", @@ -609,7 +609,7 @@ ] }, "delete": { - "description": "Deletes a long-running operation. This method indicates that the client is\nno longer interested in the operation result. It does not cancel the\noperation. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.", + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "DELETE", "id": "managedidentities.projects.locations.global.operations.delete", @@ -634,7 +634,7 @@ ] }, "get": { - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.", + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.operations.get", @@ -659,7 +659,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.", + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", "flatPath": "v1alpha1/projects/{projectsId}/locations/global/operations", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.operations.list", @@ -708,7 +708,7 @@ } } }, - "revision": "20200622", + "revision": "20200727", "rootUrl": "https://managedidentities.googleapis.com/", "schemas": { "AttachTrustRequest": { @@ -727,17 +727,17 @@ "properties": { "condition": { "$ref": "Expr", - "description": "The condition that is associated with this binding.\n\nIf the condition evaluates to `true`, then this binding applies to the\ncurrent request.\n\nIf the condition evaluates to `false`, then this binding does not apply to\nthe current request. However, a different role binding might grant the same\nrole to one or more of the members in this binding.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies)." + "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 members 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)." }, "members": { - "description": "Specifies the identities requesting access for a Cloud Platform resource.\n`members` can have the following values:\n\n* `allUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special identifier that represents anyone\n who is authenticated with a Google account or a service account.\n\n* `user:{emailid}`: An email address that represents a specific Google\n account. For example, `alice@example.com` .\n\n\n* `serviceAccount:{emailid}`: An email address that represents a service\n account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{emailid}`: An email address that represents a Google group.\n For example, `admins@example.com`.\n\n* `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a user that has been recently deleted. For\n example, `alice@example.com?uid=123456789012345678901`. If the user is\n recovered, this value reverts to `user:{emailid}` and the recovered user\n retains the role in the binding.\n\n* `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus\n unique identifier) representing a service account that has been recently\n deleted. For example,\n `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.\n If the service account is undeleted, this value reverts to\n `serviceAccount:{emailid}` and the undeleted service account retains the\n role in the binding.\n\n* `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a Google group that has been recently\n deleted. For example, `admins@example.com?uid=123456789012345678901`. If\n the group is recovered, this value reverts to `group:{emailid}` and the\n recovered group retains the role in the binding.\n\n\n* `domain:{domain}`: The G Suite domain (primary) that represents all the\n users of that domain. For example, `google.com` or `example.com`.\n\n", + "description": "Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, "type": "array" }, "role": { - "description": "Role that is assigned to `members`.\nFor example, `roles/viewer`, `roles/editor`, or `roles/owner`.", + "description": "Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.", "type": "string" } }, @@ -763,19 +763,19 @@ "id": "Domain", "properties": { "authorizedNetworks": { - "description": "Optional. The full names of the Google Compute Engine\n[networks](/compute/docs/networks-and-firewalls#networks) to which the\ninstance is connected. Network can be added using UpdateDomain later.\nDomain is only available on network part of authorized_networks.\nCaller needs to make sure that CIDR subnets do not overlap between\nnetworks, else domain creation will fail.", + "description": "Optional. The full names of the Google Compute Engine [networks](/compute/docs/networks-and-firewalls#networks) to which the instance is connected. Network can be added using UpdateDomain later. Domain is only available on network part of authorized_networks. Caller needs to make sure that CIDR subnets do not overlap between networks, else domain creation will fail.", "items": { "type": "string" }, "type": "array" }, "createTime": { - "description": "Output only. The time the instance was created. Synthetic field is\npopulated automatically by CCFE. go/ccfe-synthetic-field-user-guide", + "description": "Output only. The time the instance was created. Synthetic field is populated automatically by CCFE. go/ccfe-synthetic-field-user-guide", "format": "google-datetime", "type": "string" }, "fqdn": { - "description": "Output only. Fully-qualified domain name of the exposed domain used by\nclients to connect to the service. Similar to what would be chosen for an\nActive Directory that is set up on an internal network.", + "description": "Output only. 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 that is set up on an internal network.", "type": "string" }, "labels": { @@ -786,22 +786,22 @@ "type": "object" }, "locations": { - "description": "Required. Locations where domain needs to be provisioned.\nregions\ne.g. us-west1 or us-east4\nService supports up to 4 locations at once. Each location will use a /26\nblock.", + "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.", "items": { "type": "string" }, "type": "array" }, "managedIdentitiesAdminName": { - "description": "Optional. Name of customer-visible admin used to perform Active Directory\noperations. If not specified `setupadmin` would be used.", + "description": "Optional. Name of customer-visible admin used to perform Active Directory operations. If not specified `setupadmin` would be used.", "type": "string" }, "name": { - "description": "Output only. Unique name of the domain in this scope including projects and\nlocation using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`.", + "description": "Output only. Unique name of the domain in this scope including projects and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", "type": "string" }, "reservedIpRange": { - "description": "Required. The CIDR range of internal addresses that are reserved for this\ndomain. Reserved networks must be /24 or larger. Ranges must be\nunique and non-overlapping with existing subnets in\n[Domain].[authorized_networks].", + "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" }, "state": { @@ -822,14 +822,14 @@ "ManagedIdentities domain has been created and is fully usable.", "ManagedIdentities domain configuration is being updated.", "ManagedIdentities domain is being deleted.", - "ManagedIdentities domain is being repaired and may be unusable. Details\ncan be found in the `status_message` field.", + "ManagedIdentities domain is being repaired and may be unusable. Details can be found in the `status_message` field.", "ManagedIdentities domain is undergoing maintenance.", "ManagedIdentities domain is not serving customer requests." ], "type": "string" }, "statusMessage": { - "description": "Output only. Additional information about the current status of this\ndomain, if available.", + "description": "Output only. Additional information about the current status of this domain, if available.", "type": "string" }, "trusts": { @@ -840,7 +840,7 @@ "type": "array" }, "updateTime": { - "description": "Output only. Last update time. Synthetic field is populated automatically\nby CCFE.", + "description": "Output only. Last update time. Synthetic field is populated automatically by CCFE.", "format": "google-datetime", "type": "string" } @@ -848,29 +848,29 @@ "type": "object" }, "Empty": { - "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.", "id": "Empty", "properties": {}, "type": "object" }, "Expr": { - "description": "Represents a textual expression in the Common Expression Language (CEL)\nsyntax. CEL is a C-like expression language. The syntax and semantics of CEL\nare documented at https://github.com/google/cel-spec.\n\nExample (Comparison):\n\n title: \"Summary size limit\"\n description: \"Determines if a summary is less than 100 chars\"\n expression: \"document.summary.size() < 100\"\n\nExample (Equality):\n\n title: \"Requestor is owner\"\n description: \"Determines if requestor is the document owner\"\n expression: \"document.owner == request.auth.claims.email\"\n\nExample (Logic):\n\n title: \"Public documents\"\n description: \"Determine whether the document should be publicly visible\"\n expression: \"document.type != 'private' && document.type != 'internal'\"\n\nExample (Data Manipulation):\n\n title: \"Notification string\"\n description: \"Create a notification string with a timestamp.\"\n expression: \"'New message received at ' + string(document.create_time)\"\n\nThe exact variables and functions that may be referenced within an expression\nare determined by the service that evaluates it. See the service\ndocumentation for additional information.", + "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() < 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.", "id": "Expr", "properties": { "description": { - "description": "Optional. Description of the expression. This is a longer text which\ndescribes the expression, e.g. when hovered over it in a UI.", + "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" }, "expression": { - "description": "Textual representation of an expression in Common Expression Language\nsyntax.", + "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "location": { - "description": "Optional. String indicating the location of the expression for error\nreporting, e.g. a file name and a position in the file.", + "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" }, "title": { - "description": "Optional. Title for the expression, i.e. a short string describing\nits purpose. This can be used e.g. in UIs which allow to enter the\nexpression.", + "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" } }, @@ -882,28 +882,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -915,28 +921,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -948,28 +960,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -979,33 +997,34 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", "properties": { "consumerDefinedName": { - "description": "consumer_defined_name is the name that is set by the consumer. On the other\nhand Name field represents system-assigned id of an instance so consumers\nare not necessarily aware of it.\nconsumer_defined_name is used for notification/UI purposes for consumer to\nrecognize their instances.", + "description": "consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when the resource was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Resource labels to represent user provided metadata. Each label\nis a key-value pair, where both the key and the value are arbitrary strings\nprovided by the user.", + "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" }, "maintenancePolicyNames": { "additionalProperties": { "type": "string" }, - "description": "The MaintenancePolicies that have been attached to the instance.\nThe key must be of the type name of the oneof policy name defined in\nMaintenancePolicy, and the referenced policy must define the same policy\ntype. For complete details of MaintenancePolicy, please refer to\ngo/cloud-saas-mw-ug.", + "description": "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 complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.", "type": "object" }, "maintenanceSchedules": { "additionalProperties": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule" }, - "description": "The MaintenanceSchedule contains the scheduling information of published\nmaintenance schedule.", + "description": "The MaintenanceSchedule contains the scheduling information of published maintenance schedule.", "type": "object" }, "maintenanceSettings": { @@ -1013,40 +1032,43 @@ "description": "Optional. The MaintenanceSettings associated with instance." }, "name": { - "description": "Unique name of the resource. It uses the form:\n `projects/{project_id}/locations/{location_id}/instances/{instance_id}`", + "description": "Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}`", "type": "string" }, "producerMetadata": { "additionalProperties": { "type": "string" }, - "description": "Output only. Custom string attributes used primarily to expose\nproducer-specific information in monitoring dashboards.\nSee go/get-instance-metadata.", + "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" }, "provisionedResources": { - "description": "Output only. The list of data plane resources provisioned for this\ninstance, e.g. compute VMs. See go/get-instance-metadata.", + "description": "Output only. The list of data plane resources provisioned for this instance, e.g. compute VMs. See go/get-instance-metadata.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource" }, + "readOnly": true, "type": "array" }, "slmInstanceTemplate": { - "description": "Link to the SLM instance template. Only populated when updating SLM\ninstances via SSA's Actuation service adaptor.\nService producers with custom control plane (e.g. Cloud SQL) doesn't\nneed to populate this field. Instead they should use software_versions.", + "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" }, "sloMetadata": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata", - "description": "Output only. SLO metadata for instance classification in the\nStandardized dataplane SLO platform.\nSee go/cloud-ssa-standard-slo for feature description." + "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 }, "softwareVersions": { "additionalProperties": { "type": "string" }, - "description": "Software versions that are used to deploy this instance. This can be\nmutated by rollout services.", + "description": "Software versions that are used to deploy this instance. This can be mutated by rollout services.", "type": "object" }, "state": { - "description": "Output only. Current lifecycle state of the resource (e.g. if it's being\ncreated or ready to use).", + "description": "Output only. Current lifecycle state of the resource (e.g. if it's being created or ready to use).", "enum": [ "STATE_UNSPECIFIED", "CREATING", @@ -1065,26 +1087,29 @@ "Instance is being deleted.", "Instance encountered an error and is in indeterministic state." ], + "readOnly": true, "type": "string" }, "tenantProjectId": { - "description": "Output only. ID of the associated GCP tenant project.\nSee go/get-instance-metadata.", + "description": "Output only. ID of the associated GCP tenant project. See go/get-instance-metadata.", + "readOnly": true, "type": "string" }, "updateTime": { "description": "Output only. Timestamp when the resource was last modified.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule": { - "description": "Maintenance schedule which is exposed to customer and potentially end user,\nindicating published upcoming future maintenance schedule", + "description": "Maintenance schedule which is exposed to customer and potentially end user, indicating published upcoming future maintenance schedule", "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule", "properties": { "canReschedule": { - "description": "Can this scheduled update be rescheduled?\nBy default, it's true and API needs to do explicitly check whether it's\nset, if it's set as false explicitly, it's false", + "description": "Can this scheduled update be rescheduled? By default, it's true and API needs to do explicitly check whether it's set, if it's set as false explicitly, it's false", "type": "boolean" }, "endTime": { @@ -1093,7 +1118,7 @@ "type": "string" }, "rolloutManagementPolicy": { - "description": "The rollout management policy this maintenance schedule is associated\nwith. When doing reschedule update request, the reschedule should be\nagainst this given policy.", + "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" }, "startTime": { @@ -1105,22 +1130,22 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings": { - "description": "Maintenance settings associated with instance. Allows service producers and\nend users to assign settings that controls maintenance on this instance.", + "description": "Maintenance settings associated with instance. Allows service producers and end users to assign settings that controls maintenance on this instance.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings", "properties": { "exclude": { - "description": "Optional. Exclude instance from maintenance. When true, rollout service will not\nattempt maintenance on the instance. Rollout service will include the\ninstance in reported rollout progress as not attempted.", + "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" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata": { - "description": "Node information for custom per-node SLO implementations.\nSSA does not support per-node SLO, but producers can populate per-node\ninformation in SloMetadata for custom precomputations.\nSSA Eligibility Exporter will emit per-node metric based on this information.", + "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.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata", "properties": { "exclusions": { - "description": "By default node is eligible if instance is eligible.\nBut individual node might be excluded from SLO by adding entry here.\nFor semantic see SloMetadata.exclusions.\nIf both instance and node level exclusions are present for time period,\nthe node level's reason will be reported by Eligibility Exporter.", + "description": "By default node is eligible if instance is eligible. But individual node might be excluded from SLO by adding entry here. For semantic see SloMetadata.exclusions. If both instance and node level exclusions are present for time period, the node level's reason will be reported by Eligibility Exporter.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion" }, @@ -1131,7 +1156,7 @@ "type": "string" }, "nodeId": { - "description": "The id of the node.\nThis should be equal to SaasInstanceNode.node_id.", + "description": "The id of the node. This should be equal to SaasInstanceNode.node_id.", "type": "string" } }, @@ -1142,18 +1167,18 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource", "properties": { "resourceType": { - "description": "Type of the resource. This can be either a GCP resource or a custom one\n(e.g. another cloud provider's VM). For GCP compute resources use singular\nform of the names listed in GCP compute API documentation\n(https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with\n'compute-', for example: 'compute-instance', 'compute-disk',\n'compute-autoscaler'.", + "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.\n\"https://www.googleapis.com/compute/v1/projects/...)\".", + "description": "URL identifying the resource, e.g. \"https://www.googleapis.com/compute/v1/projects/...)\".", "type": "string" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility": { - "description": "SloEligibility is a tuple containing eligibility value: true if an instance\nis eligible for SLO calculation or false if it should be excluded from all\nSLO-related calculations along with a user-defined reason.", + "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.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility", "properties": { "eligible": { @@ -1161,7 +1186,7 @@ "type": "boolean" }, "reason": { - "description": "User-defined reason for the current value of instance eligibility. Usually,\nthis can be directly mapped to the internal state. An empty reason is\nallowed.", + "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" } }, @@ -1172,16 +1197,16 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion", "properties": { "duration": { - "description": "Exclusion duration. No restrictions on the possible values.\n\nWhen an ongoing operation is taking longer than initially expected,\nan existing entry in the exclusion list can be updated by extending the\nduration. This is supported by the subsystem exporting eligibility data\nas long as such extension is committed at least 10 minutes before the\noriginal exclusion expiration - otherwise it is possible that there will\nbe \"gaps\" in the exclusion application in the exported timeseries.", + "description": "Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be \"gaps\" in the exclusion application in the exported timeseries.", "format": "google-duration", "type": "string" }, "reason": { - "description": "Human-readable reason for the exclusion.\nThis should be a static string (e.g. \"Disruptive update in progress\")\nand should not contain dynamically generated data (e.g. instance name).\nCan be left empty.", + "description": "Human-readable reason for the exclusion. This should be a static string (e.g. \"Disruptive update in progress\") and should not contain dynamically generated data (e.g. instance name). Can be left empty.", "type": "string" }, "sliName": { - "description": "Name of an SLI that this exclusion applies to. Can be left empty,\nsignaling that the instance should be excluded from all SLIs defined\nin the service SLO configuration.", + "description": "Name of an SLI that this exclusion applies to. Can be left empty, signaling that the instance should be excluded from all SLIs defined in the service SLO configuration.", "type": "string" }, "startTime": { @@ -1193,7 +1218,7 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata": { - "description": "SloMetadata contains resources required for proper SLO classification of the\ninstance.", + "description": "SloMetadata contains resources required for proper SLO classification of the instance.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata", "properties": { "eligibility": { @@ -1201,21 +1226,21 @@ "description": "Optional. User-defined instance eligibility." }, "exclusions": { - "description": "List of SLO exclusion windows. When multiple entries in the list match\n(matching the exclusion time-window against current time point)\nthe exclusion reason used in the first matching entry will be published.\n\nIt is not needed to include expired exclusion in this list, as only the\ncurrently applicable exclusions are taken into account by the eligibility\nexporting subsystem (the historical state of exclusions will be reflected\nin the historically produced timeseries regardless of the current state).\n\nThis field can be used to mark the instance as temporary ineligible\nfor the purpose of SLO calculation. For permanent instance SLO exclusion,\nuse of custom instance eligibility is recommended. See 'eligibility' field\nbelow.", + "description": "List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion" }, "type": "array" }, "nodes": { - "description": "Optional. List of nodes.\nSome producers need to use per-node metadata to calculate SLO.\nThis field allows such producers to publish per-node SLO meta data,\nwhich will be consumed by SSA Eligibility Exporter and published in the\nform of per node metric to Monarch.", + "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.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata" }, "type": "array" }, "tier": { - "description": "Name of the SLO tier the Instance belongs to. This name will be expected to\nmatch the tiers specified in the service SLO configuration.\n\nField is mandatory and must not be empty.", + "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" } }, @@ -1232,7 +1257,7 @@ "type": "array" }, "nextPageToken": { - "description": "Token to retrieve the next page of results, or empty if there are no more\nresults in the list.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { @@ -1286,14 +1311,14 @@ "id": "Location", "properties": { "displayName": { - "description": "The friendly name for this location, typically a nearby city name.\nFor example, \"Tokyo\".", + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Cross-service attributes for the location. For example\n\n {\"cloud.googleapis.com/region\": \"us-east1\"}", + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object" }, "locationId": { @@ -1305,22 +1330,22 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata. For example the available capacity at the given\nlocation.", + "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object" }, "name": { - "description": "Resource name for the location, which may vary between implementations.\nFor example: `\"projects/example-project/locations/us-east1\"`", + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" } }, "type": "object" }, "Operation": { - "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", + "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", "properties": { "done": { - "description": "If the value is `false`, it means the operation is still in progress.\nIf `true`, the operation is completed, and either `error` or `response` is\navailable.", + "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": { @@ -1332,11 +1357,11 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata associated with the operation. It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata. Any method that returns a\nlong-running operation should document the metadata type, if any.", + "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" }, "name": { - "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should be a resource name ending with `operations/{unique_id}`.", + "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" }, "response": { @@ -1344,7 +1369,7 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.", + "description": "The normal response of the operation in case of success. 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" } }, @@ -1359,7 +1384,7 @@ "type": "string" }, "cancelRequested": { - "description": "[Output only] Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "type": "boolean" }, "createTime": { @@ -1388,23 +1413,23 @@ "type": "object" }, "Policy": { - "description": "An Identity and Access Management (IAM) policy, which specifies access\ncontrols for Google Cloud resources.\n\n\nA `Policy` is a collection of `bindings`. A `binding` binds one or more\n`members` to a single `role`. Members can be user accounts, service accounts,\nGoogle groups, and domains (such as G Suite). A `role` is a named list of\npermissions; each `role` can be an IAM predefined role or a user-created\ncustom role.\n\nFor some types of Google Cloud resources, a `binding` can also specify a\n`condition`, which is a logical expression that allows access to a resource\nonly if the expression evaluates to `true`. A condition can add constraints\nbased on attributes of the request, the resource, or both. To learn which\nresources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).\n\n**JSON example:**\n\n {\n \"bindings\": [\n {\n \"role\": \"roles/resourcemanager.organizationAdmin\",\n \"members\": [\n \"user:mike@example.com\",\n \"group:admins@example.com\",\n \"domain:google.com\",\n \"serviceAccount:my-project-id@appspot.gserviceaccount.com\"\n ]\n },\n {\n \"role\": \"roles/resourcemanager.organizationViewer\",\n \"members\": [\n \"user:eve@example.com\"\n ],\n \"condition\": {\n \"title\": \"expirable access\",\n \"description\": \"Does not grant access after Sep 2020\",\n \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\",\n }\n }\n ],\n \"etag\": \"BwWWja0YfJA=\",\n \"version\": 3\n }\n\n**YAML example:**\n\n bindings:\n - members:\n - user:mike@example.com\n - group:admins@example.com\n - domain:google.com\n - serviceAccount:my-project-id@appspot.gserviceaccount.com\n role: roles/resourcemanager.organizationAdmin\n - members:\n - user:eve@example.com\n role: roles/resourcemanager.organizationViewer\n condition:\n title: expirable access\n description: Does not grant access after Sep 2020\n expression: request.time < timestamp('2020-10-01T00:00:00.000Z')\n - etag: BwWWja0YfJA=\n - version: 3\n\nFor a description of IAM and its features, see the\n[IAM documentation](https://cloud.google.com/iam/docs/).", + "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` to a single `role`. Members 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 < 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 < 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/).", "id": "Policy", "properties": { "bindings": { - "description": "Associates a list of `members` to a `role`. Optionally, may specify a\n`condition` that determines how and when the `bindings` are applied. Each\nof the `bindings` must contain at least one member.", + "description": "Associates a list of `members` to 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 member.", "items": { "$ref": "Binding" }, "type": "array" }, "etag": { - "description": "`etag` is used for optimistic concurrency control as a way to help\nprevent simultaneous updates of a policy from overwriting each other.\nIt is strongly suggested that systems make use of the `etag` in the\nread-modify-write cycle to perform policy updates in order to avoid race\nconditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems are expected to put that etag in the request to `setIamPolicy` to\nensure that their change will be applied to the same version of the policy.\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.", + "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.", "format": "byte", "type": "string" }, "version": { - "description": "Specifies the format of the policy.\n\nValid values are `0`, `1`, and `3`. Requests that specify an invalid value\nare rejected.\n\nAny operation that affects conditional role bindings must specify version\n`3`. This requirement applies to the following operations:\n\n* Getting a policy that includes a conditional role binding\n* Adding a conditional role binding to a policy\n* Changing a conditional role binding in a policy\n* Removing any role binding, with or without a condition, from a policy\n that includes conditions\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.\n\nIf a policy does not include any conditions, operations on that policy may\nspecify any valid version or leave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "type": "integer" } @@ -1442,13 +1467,13 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An empty policy is a\nvalid policy but certain Cloud Platform services (such as Projects)\nmight reject them." + "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 Cloud Platform services (such as Projects) might reject them." } }, "type": "object" }, "Status": { - "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", + "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).", "id": "Status", "properties": { "code": { @@ -1457,7 +1482,7 @@ "type": "integer" }, "details": { - "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", @@ -1468,7 +1493,7 @@ "type": "array" }, "message": { - "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", + "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" } }, @@ -1479,7 +1504,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with\nwildcards (such as '*' or 'storage.*') are not allowed. For more\ninformation see\n[IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, @@ -1493,7 +1518,7 @@ "id": "TestIamPermissionsResponse", "properties": { "permissions": { - "description": "A subset of `TestPermissionsRequest.permissions` that the caller is\nallowed.", + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "items": { "type": "string" }, @@ -1503,7 +1528,7 @@ "type": "object" }, "Trust": { - "description": "Represents a relationship between two domains which makes it possible\nfor users in one domain to be authenticated by a dc in another domain.\nRefer\nhttps://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc731335(v%3dws.10)", + "description": "Represents a relationship between two domains which makes it possible for users in one domain to be authenticated by a dc in another domain. Refer https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc731335(v%3dws.10)", "id": "Trust", "properties": { "createTime": { @@ -1512,12 +1537,12 @@ "type": "string" }, "lastKnownTrustConnectedHeartbeatTime": { - "description": "Output only. The last heartbeat time when the trust was known to be\nconnected.", + "description": "Output only. The last heartbeat time when the trust was known to be connected.", "format": "google-datetime", "type": "string" }, "selectiveAuthentication": { - "description": "The trust authentication type which decides whether the trusted side has\nforest/domain wide access or selective access to approved set of resources.", + "description": "The trust authentication type which decides whether the trusted side has forest/domain wide access or selective access to approved set of resources.", "type": "boolean" }, "state": { @@ -1541,22 +1566,22 @@ "type": "string" }, "stateDescription": { - "description": "Output only. Additional information about the current state of this\ntrust, if available.", + "description": "Output only. Additional information about the current state of this trust, if available.", "type": "string" }, "targetDnsIpAddresses": { - "description": "The target dns server ip addresses which can resolve the remote domain\ninvolved in trust.", + "description": "The target dns server ip addresses which can resolve the remote domain involved in trust.", "items": { "type": "string" }, "type": "array" }, "targetDomainName": { - "description": "The fully qualified target domain name which will be in trust with current\ndomain.", + "description": "The fully qualified target domain name which will be in trust with current domain.", "type": "string" }, "trustDirection": { - "description": "The trust direction decides the current domain is trusted, trusting or\nboth.", + "description": "The trust direction decides the current domain is trusted, trusting or both.", "enum": [ "TRUST_DIRECTION_UNSPECIFIED", "INBOUND", @@ -1572,7 +1597,7 @@ "type": "string" }, "trustHandshakeSecret": { - "description": "Input only, and will not be stored. The trust secret used for handshake\nwith target domain.", + "description": "Input only, and will not be stored. The trust secret used for handshake with target domain.", "type": "string" }, "trustType": { diff --git a/discovery/managedidentities-v1beta1.json b/discovery/managedidentities-v1beta1.json index bb18a2b3547..a41a9742922 100644 --- a/discovery/managedidentities-v1beta1.json +++ b/discovery/managedidentities-v1beta1.json @@ -149,7 +149,7 @@ "type": "string" }, "includeUnrevealedLocations": { - "description": "If true, the returned list will include locations which are not yet\nrevealed.", + "description": "If true, the returned list will include locations which are not yet revealed.", "location": "query", "type": "boolean" }, @@ -196,7 +196,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -224,12 +224,12 @@ ], "parameters": { "domainName": { - "description": "Required. A domain name, e.g. mydomain.myorg.com, with the following restrictions:\n * Must contain only lowercase letters, numbers, periods and hyphens.\n * Must start with a letter.\n * Must contain between 2-64 characters.\n * Must end with a number or a letter.\n * Must not start with period.\n * First segement length (mydomain form example above) shouldn't exceed\n 15 chars.\n * The last segment cannot be fully numeric.\n * Must be unique within the customer project.", + "description": "Required. A domain name, e.g. mydomain.myorg.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 segement length (mydomain form 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" }, "parent": { - "description": "Required. The resource project name and location using the form:\n`projects/{project_id}/locations/global`", + "description": "Required. The resource project name and location using the form: `projects/{project_id}/locations/global`", "location": "path", "pattern": "^projects/[^/]+/locations/global$", "required": true, @@ -257,7 +257,7 @@ ], "parameters": { "name": { - "description": "Required. The domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -282,7 +282,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name, and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -310,7 +310,7 @@ ], "parameters": { "name": { - "description": "Required. The domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -326,7 +326,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a resource.\nReturns an empty policy if the resource exists and does not have a policy\nset.", + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/domains/{domainsId}:getIamPolicy", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.domains.getIamPolicy", @@ -335,13 +335,13 @@ ], "parameters": { "options.requestedPolicyVersion": { - "description": "Optional. The policy format version to be returned.\n\nValid values are 0, 1, and 3. Requests specifying an invalid value will be\nrejected.\n\nRequests for policies with any conditional bindings must specify version 3.\nPolicies without any conditional bindings may specify any valid value or\nleave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "description": "Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "location": "query", "type": "integer" }, "resource": { - "description": "REQUIRED: The resource for which the policy is being requested.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -366,28 +366,28 @@ ], "parameters": { "filter": { - "description": "Optional. A filter specifying constraints of a list operation.\nFor example, `Domain.fqdn=\"mydomain.myorginization\"`.", + "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\n[Sorting\norder](https://cloud.google.com/apis/design/design_patterns#sorting_order)\nfor more information.", + "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" }, "pageSize": { - "description": "Optional. The maximum number of items to return.\nIf not specified, a default value of 1000 will be used.\nRegardless of the page_size value, the response may include a partial list.\nCallers should rely on a response's\nnext_page_token\nto determine if there are additional results to list.", + "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.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The `next_page_token` value returned from a previous ListDomainsRequest\nrequest, if any.", + "description": "The `next_page_token` value returned from a previous ListDomainsRequest request, if any.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The resource name of the domain location using the form:\n`projects/{project_id}/locations/global`", + "description": "Required. The resource name of the domain location using the form: `projects/{project_id}/locations/global`", "location": "path", "pattern": "^projects/[^/]+/locations/global$", "required": true, @@ -412,14 +412,14 @@ ], "parameters": { "name": { - "description": "Output only. The unique name of the domain using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`.", + "description": "Output only. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, "type": "string" }, "updateMask": { - "description": "Required. Mask of fields to update. At least one path must be supplied in this\nfield. The elements of the repeated paths field may only include\nfields from Domain:\n * `labels`\n * `locations`\n * `authorized_networks`", + "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`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -446,7 +446,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -474,7 +474,7 @@ ], "parameters": { "name": { - "description": "Required. The domain resource name using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -493,7 +493,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any\nexisting policy.\n\nCan return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/domains/{domainsId}:setIamPolicy", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.setIamPolicy", @@ -502,7 +502,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy is being specified.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -521,7 +521,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that a caller has on the specified resource.\nIf the resource does not exist, this will return an empty set of\npermissions, not a `NOT_FOUND` error.\n\nNote: This operation is designed to be used for building permission-aware\nUIs and command-line tools, not for authorization checking. This operation\nmay \"fail open\" without warning.", + "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.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/domains/{domainsId}:testIamPermissions", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.testIamPermissions", @@ -530,7 +530,7 @@ ], "parameters": { "resource": { - "description": "REQUIRED: The resource for which the policy detail is being requested.\nSee the operation documentation for the appropriate value for this field.", + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -549,7 +549,7 @@ ] }, "validateTrust": { - "description": "Validates a trust state, that the target domain is reachable, and that the\ntarget domain is able to accept incoming trust requests.", + "description": "Validates a trust state, that the target domain is reachable, and that the target domain is able to accept incoming trust requests.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/domains/{domainsId}:validateTrust", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.domains.validateTrust", @@ -558,7 +558,7 @@ ], "parameters": { "name": { - "description": "Required. The resource domain name, project name, and location using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`", + "description": "Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`", "location": "path", "pattern": "^projects/[^/]+/locations/global/domains/[^/]+$", "required": true, @@ -581,7 +581,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "managedidentities.projects.locations.global.operations.cancel", @@ -609,7 +609,7 @@ ] }, "delete": { - "description": "Deletes a long-running operation. This method indicates that the client is\nno longer interested in the operation result. It does not cancel the\noperation. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.", + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "DELETE", "id": "managedidentities.projects.locations.global.operations.delete", @@ -634,7 +634,7 @@ ] }, "get": { - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.", + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/operations/{operationsId}", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.operations.get", @@ -659,7 +659,7 @@ ] }, "list": { - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.", + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", "flatPath": "v1beta1/projects/{projectsId}/locations/global/operations", "httpMethod": "GET", "id": "managedidentities.projects.locations.global.operations.list", @@ -708,11 +708,11 @@ } } }, - "revision": "20200622", + "revision": "20200727", "rootUrl": "https://managedidentities.googleapis.com/", "schemas": { "AttachTrustRequest": { - "description": "Request message for\nAttachTrust", + "description": "Request message for AttachTrust", "id": "AttachTrustRequest", "properties": { "trust": { @@ -728,17 +728,17 @@ "properties": { "condition": { "$ref": "Expr", - "description": "The condition that is associated with this binding.\n\nIf the condition evaluates to `true`, then this binding applies to the\ncurrent request.\n\nIf the condition evaluates to `false`, then this binding does not apply to\nthe current request. However, a different role binding might grant the same\nrole to one or more of the members in this binding.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM\ndocumentation](https://cloud.google.com/iam/help/conditions/resource-policies)." + "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 members 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)." }, "members": { - "description": "Specifies the identities requesting access for a Cloud Platform resource.\n`members` can have the following values:\n\n* `allUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special identifier that represents anyone\n who is authenticated with a Google account or a service account.\n\n* `user:{emailid}`: An email address that represents a specific Google\n account. For example, `alice@example.com` .\n\n\n* `serviceAccount:{emailid}`: An email address that represents a service\n account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{emailid}`: An email address that represents a Google group.\n For example, `admins@example.com`.\n\n* `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a user that has been recently deleted. For\n example, `alice@example.com?uid=123456789012345678901`. If the user is\n recovered, this value reverts to `user:{emailid}` and the recovered user\n retains the role in the binding.\n\n* `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus\n unique identifier) representing a service account that has been recently\n deleted. For example,\n `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.\n If the service account is undeleted, this value reverts to\n `serviceAccount:{emailid}` and the undeleted service account retains the\n role in the binding.\n\n* `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique\n identifier) representing a Google group that has been recently\n deleted. For example, `admins@example.com?uid=123456789012345678901`. If\n the group is recovered, this value reverts to `group:{emailid}` and the\n recovered group retains the role in the binding.\n\n\n* `domain:{domain}`: The G Suite domain (primary) that represents all the\n users of that domain. For example, `google.com` or `example.com`.\n\n", + "description": "Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, "type": "array" }, "role": { - "description": "Role that is assigned to `members`.\nFor example, `roles/viewer`, `roles/editor`, or `roles/owner`.", + "description": "Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.", "type": "string" } }, @@ -751,7 +751,7 @@ "type": "object" }, "DetachTrustRequest": { - "description": "Request message for\nDetachTrust", + "description": "Request message for DetachTrust", "id": "DetachTrustRequest", "properties": { "trust": { @@ -766,11 +766,11 @@ "id": "Domain", "properties": { "admin": { - "description": "Optional. The name of delegated administrator account used to perform\nActive Directory operations. If not specified, `setupadmin` will be used.", + "description": "Optional. The name of delegated administrator account used to perform Active Directory operations. If not specified, `setupadmin` will be used.", "type": "string" }, "authorizedNetworks": { - "description": "Optional. The full names of the Google Compute Engine\n[networks](/compute/docs/networks-and-firewalls#networks) the domain\ninstance is connected to. Networks can be added using UpdateDomain.\nThe domain is only available on networks listed in `authorized_networks`.\nIf CIDR subnets overlap between networks, domain creation will fail.", + "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.", "items": { "type": "string" }, @@ -779,10 +779,12 @@ "createTime": { "description": "Output only. The time the instance was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "fqdn": { - "description": "Output only. The fully-qualified domain name of the exposed domain used by\nclients to connect to the service. Similar to what would be chosen for an\nActive Directory set up on an internal network.", + "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" }, "labels": { @@ -793,18 +795,19 @@ "type": "object" }, "locations": { - "description": "Required. Locations where domain needs to be provisioned.\nregions\ne.g. us-west1 or us-east4\nService supports up to 4 locations at once. Each location will use a /26\nblock.", + "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.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "Output only. The unique name of the domain using the form:\n`projects/{project_id}/locations/global/domains/{domain_name}`.", + "description": "Output only. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`.", + "readOnly": true, "type": "string" }, "reservedIpRange": { - "description": "Required. The CIDR range of internal addresses that are reserved for this\ndomain. Reserved networks must be /24 or larger. Ranges must be\nunique and non-overlapping with existing subnets in\n[Domain].[authorized_networks].", + "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" }, "state": { @@ -825,14 +828,16 @@ "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\ncan be found in the `status_message` field.", + "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." ], + "readOnly": true, "type": "string" }, "statusMessage": { - "description": "Output only. Additional information about the current status of this\ndomain, if available.", + "description": "Output only. Additional information about the current status of this domain, if available.", + "readOnly": true, "type": "string" }, "trusts": { @@ -840,40 +845,42 @@ "items": { "$ref": "Trust" }, + "readOnly": true, "type": "array" }, "updateTime": { "description": "Output only. The last update time.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "Empty": { - "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.", "id": "Empty", "properties": {}, "type": "object" }, "Expr": { - "description": "Represents a textual expression in the Common Expression Language (CEL)\nsyntax. CEL is a C-like expression language. The syntax and semantics of CEL\nare documented at https://github.com/google/cel-spec.\n\nExample (Comparison):\n\n title: \"Summary size limit\"\n description: \"Determines if a summary is less than 100 chars\"\n expression: \"document.summary.size() < 100\"\n\nExample (Equality):\n\n title: \"Requestor is owner\"\n description: \"Determines if requestor is the document owner\"\n expression: \"document.owner == request.auth.claims.email\"\n\nExample (Logic):\n\n title: \"Public documents\"\n description: \"Determine whether the document should be publicly visible\"\n expression: \"document.type != 'private' && document.type != 'internal'\"\n\nExample (Data Manipulation):\n\n title: \"Notification string\"\n description: \"Create a notification string with a timestamp.\"\n expression: \"'New message received at ' + string(document.create_time)\"\n\nThe exact variables and functions that may be referenced within an expression\nare determined by the service that evaluates it. See the service\ndocumentation for additional information.", + "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() < 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.", "id": "Expr", "properties": { "description": { - "description": "Optional. Description of the expression. This is a longer text which\ndescribes the expression, e.g. when hovered over it in a UI.", + "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" }, "expression": { - "description": "Textual representation of an expression in Common Expression Language\nsyntax.", + "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "location": { - "description": "Optional. String indicating the location of the expression for error\nreporting, e.g. a file name and a position in the file.", + "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" }, "title": { - "description": "Optional. Title for the expression, i.e. a short string describing\nits purpose. This can be used e.g. in UIs which allow to enter the\nexpression.", + "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" } }, @@ -885,28 +892,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -918,28 +931,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -951,28 +970,34 @@ "properties": { "apiVersion": { "description": "Output only. API version used to start the operation.", + "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The time the operation was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "endTime": { "description": "Output only. The time the operation finished running.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "requestedCancellation": { - "description": "Output only. Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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" }, "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" } }, @@ -982,33 +1007,34 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", "properties": { "consumerDefinedName": { - "description": "consumer_defined_name is the name that is set by the consumer. On the other\nhand Name field represents system-assigned id of an instance so consumers\nare not necessarily aware of it.\nconsumer_defined_name is used for notification/UI purposes for consumer to\nrecognize their instances.", + "description": "consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when the resource was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Resource labels to represent user provided metadata. Each label\nis a key-value pair, where both the key and the value are arbitrary strings\nprovided by the user.", + "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" }, "maintenancePolicyNames": { "additionalProperties": { "type": "string" }, - "description": "The MaintenancePolicies that have been attached to the instance.\nThe key must be of the type name of the oneof policy name defined in\nMaintenancePolicy, and the referenced policy must define the same policy\ntype. For complete details of MaintenancePolicy, please refer to\ngo/cloud-saas-mw-ug.", + "description": "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 complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.", "type": "object" }, "maintenanceSchedules": { "additionalProperties": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule" }, - "description": "The MaintenanceSchedule contains the scheduling information of published\nmaintenance schedule.", + "description": "The MaintenanceSchedule contains the scheduling information of published maintenance schedule.", "type": "object" }, "maintenanceSettings": { @@ -1016,40 +1042,43 @@ "description": "Optional. The MaintenanceSettings associated with instance." }, "name": { - "description": "Unique name of the resource. It uses the form:\n `projects/{project_id}/locations/{location_id}/instances/{instance_id}`", + "description": "Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}`", "type": "string" }, "producerMetadata": { "additionalProperties": { "type": "string" }, - "description": "Output only. Custom string attributes used primarily to expose\nproducer-specific information in monitoring dashboards.\nSee go/get-instance-metadata.", + "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" }, "provisionedResources": { - "description": "Output only. The list of data plane resources provisioned for this\ninstance, e.g. compute VMs. See go/get-instance-metadata.", + "description": "Output only. The list of data plane resources provisioned for this instance, e.g. compute VMs. See go/get-instance-metadata.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource" }, + "readOnly": true, "type": "array" }, "slmInstanceTemplate": { - "description": "Link to the SLM instance template. Only populated when updating SLM\ninstances via SSA's Actuation service adaptor.\nService producers with custom control plane (e.g. Cloud SQL) doesn't\nneed to populate this field. Instead they should use software_versions.", + "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" }, "sloMetadata": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata", - "description": "Output only. SLO metadata for instance classification in the\nStandardized dataplane SLO platform.\nSee go/cloud-ssa-standard-slo for feature description." + "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 }, "softwareVersions": { "additionalProperties": { "type": "string" }, - "description": "Software versions that are used to deploy this instance. This can be\nmutated by rollout services.", + "description": "Software versions that are used to deploy this instance. This can be mutated by rollout services.", "type": "object" }, "state": { - "description": "Output only. Current lifecycle state of the resource (e.g. if it's being\ncreated or ready to use).", + "description": "Output only. Current lifecycle state of the resource (e.g. if it's being created or ready to use).", "enum": [ "STATE_UNSPECIFIED", "CREATING", @@ -1068,26 +1097,29 @@ "Instance is being deleted.", "Instance encountered an error and is in indeterministic state." ], + "readOnly": true, "type": "string" }, "tenantProjectId": { - "description": "Output only. ID of the associated GCP tenant project.\nSee go/get-instance-metadata.", + "description": "Output only. ID of the associated GCP tenant project. See go/get-instance-metadata.", + "readOnly": true, "type": "string" }, "updateTime": { "description": "Output only. Timestamp when the resource was last modified.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule": { - "description": "Maintenance schedule which is exposed to customer and potentially end user,\nindicating published upcoming future maintenance schedule", + "description": "Maintenance schedule which is exposed to customer and potentially end user, indicating published upcoming future maintenance schedule", "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule", "properties": { "canReschedule": { - "description": "Can this scheduled update be rescheduled?\nBy default, it's true and API needs to do explicitly check whether it's\nset, if it's set as false explicitly, it's false", + "description": "Can this scheduled update be rescheduled? By default, it's true and API needs to do explicitly check whether it's set, if it's set as false explicitly, it's false", "type": "boolean" }, "endTime": { @@ -1096,7 +1128,7 @@ "type": "string" }, "rolloutManagementPolicy": { - "description": "The rollout management policy this maintenance schedule is associated\nwith. When doing reschedule update request, the reschedule should be\nagainst this given policy.", + "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" }, "startTime": { @@ -1108,22 +1140,22 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings": { - "description": "Maintenance settings associated with instance. Allows service producers and\nend users to assign settings that controls maintenance on this instance.", + "description": "Maintenance settings associated with instance. Allows service producers and end users to assign settings that controls maintenance on this instance.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings", "properties": { "exclude": { - "description": "Optional. Exclude instance from maintenance. When true, rollout service will not\nattempt maintenance on the instance. Rollout service will include the\ninstance in reported rollout progress as not attempted.", + "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" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata": { - "description": "Node information for custom per-node SLO implementations.\nSSA does not support per-node SLO, but producers can populate per-node\ninformation in SloMetadata for custom precomputations.\nSSA Eligibility Exporter will emit per-node metric based on this information.", + "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.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata", "properties": { "exclusions": { - "description": "By default node is eligible if instance is eligible.\nBut individual node might be excluded from SLO by adding entry here.\nFor semantic see SloMetadata.exclusions.\nIf both instance and node level exclusions are present for time period,\nthe node level's reason will be reported by Eligibility Exporter.", + "description": "By default node is eligible if instance is eligible. But individual node might be excluded from SLO by adding entry here. For semantic see SloMetadata.exclusions. If both instance and node level exclusions are present for time period, the node level's reason will be reported by Eligibility Exporter.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion" }, @@ -1134,7 +1166,7 @@ "type": "string" }, "nodeId": { - "description": "The id of the node.\nThis should be equal to SaasInstanceNode.node_id.", + "description": "The id of the node. This should be equal to SaasInstanceNode.node_id.", "type": "string" } }, @@ -1145,18 +1177,18 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource", "properties": { "resourceType": { - "description": "Type of the resource. This can be either a GCP resource or a custom one\n(e.g. another cloud provider's VM). For GCP compute resources use singular\nform of the names listed in GCP compute API documentation\n(https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with\n'compute-', for example: 'compute-instance', 'compute-disk',\n'compute-autoscaler'.", + "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.\n\"https://www.googleapis.com/compute/v1/projects/...)\".", + "description": "URL identifying the resource, e.g. \"https://www.googleapis.com/compute/v1/projects/...)\".", "type": "string" } }, "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility": { - "description": "SloEligibility is a tuple containing eligibility value: true if an instance\nis eligible for SLO calculation or false if it should be excluded from all\nSLO-related calculations along with a user-defined reason.", + "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.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility", "properties": { "eligible": { @@ -1164,7 +1196,7 @@ "type": "boolean" }, "reason": { - "description": "User-defined reason for the current value of instance eligibility. Usually,\nthis can be directly mapped to the internal state. An empty reason is\nallowed.", + "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" } }, @@ -1175,16 +1207,16 @@ "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion", "properties": { "duration": { - "description": "Exclusion duration. No restrictions on the possible values.\n\nWhen an ongoing operation is taking longer than initially expected,\nan existing entry in the exclusion list can be updated by extending the\nduration. This is supported by the subsystem exporting eligibility data\nas long as such extension is committed at least 10 minutes before the\noriginal exclusion expiration - otherwise it is possible that there will\nbe \"gaps\" in the exclusion application in the exported timeseries.", + "description": "Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be \"gaps\" in the exclusion application in the exported timeseries.", "format": "google-duration", "type": "string" }, "reason": { - "description": "Human-readable reason for the exclusion.\nThis should be a static string (e.g. \"Disruptive update in progress\")\nand should not contain dynamically generated data (e.g. instance name).\nCan be left empty.", + "description": "Human-readable reason for the exclusion. This should be a static string (e.g. \"Disruptive update in progress\") and should not contain dynamically generated data (e.g. instance name). Can be left empty.", "type": "string" }, "sliName": { - "description": "Name of an SLI that this exclusion applies to. Can be left empty,\nsignaling that the instance should be excluded from all SLIs defined\nin the service SLO configuration.", + "description": "Name of an SLI that this exclusion applies to. Can be left empty, signaling that the instance should be excluded from all SLIs defined in the service SLO configuration.", "type": "string" }, "startTime": { @@ -1196,7 +1228,7 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata": { - "description": "SloMetadata contains resources required for proper SLO classification of the\ninstance.", + "description": "SloMetadata contains resources required for proper SLO classification of the instance.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata", "properties": { "eligibility": { @@ -1204,28 +1236,28 @@ "description": "Optional. User-defined instance eligibility." }, "exclusions": { - "description": "List of SLO exclusion windows. When multiple entries in the list match\n(matching the exclusion time-window against current time point)\nthe exclusion reason used in the first matching entry will be published.\n\nIt is not needed to include expired exclusion in this list, as only the\ncurrently applicable exclusions are taken into account by the eligibility\nexporting subsystem (the historical state of exclusions will be reflected\nin the historically produced timeseries regardless of the current state).\n\nThis field can be used to mark the instance as temporary ineligible\nfor the purpose of SLO calculation. For permanent instance SLO exclusion,\nuse of custom instance eligibility is recommended. See 'eligibility' field\nbelow.", + "description": "List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion" }, "type": "array" }, "nodes": { - "description": "Optional. List of nodes.\nSome producers need to use per-node metadata to calculate SLO.\nThis field allows such producers to publish per-node SLO meta data,\nwhich will be consumed by SSA Eligibility Exporter and published in the\nform of per node metric to Monarch.", + "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.", "items": { "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata" }, "type": "array" }, "tier": { - "description": "Name of the SLO tier the Instance belongs to. This name will be expected to\nmatch the tiers specified in the service SLO configuration.\n\nField is mandatory and must not be empty.", + "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" } }, "type": "object" }, "ListDomainsResponse": { - "description": "Response message for\nListDomains", + "description": "Response message for ListDomains", "id": "ListDomainsResponse", "properties": { "domains": { @@ -1236,7 +1268,7 @@ "type": "array" }, "nextPageToken": { - "description": "A token to retrieve the next page of results, or empty if there are no more\nresults in the list.", + "description": "A token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { @@ -1290,14 +1322,14 @@ "id": "Location", "properties": { "displayName": { - "description": "The friendly name for this location, typically a nearby city name.\nFor example, \"Tokyo\".", + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Cross-service attributes for the location. For example\n\n {\"cloud.googleapis.com/region\": \"us-east1\"}", + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object" }, "locationId": { @@ -1309,22 +1341,22 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata. For example the available capacity at the given\nlocation.", + "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object" }, "name": { - "description": "Resource name for the location, which may vary between implementations.\nFor example: `\"projects/example-project/locations/us-east1\"`", + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" } }, "type": "object" }, "Operation": { - "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", + "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", "properties": { "done": { - "description": "If the value is `false`, it means the operation is still in progress.\nIf `true`, the operation is completed, and either `error` or `response` is\navailable.", + "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": { @@ -1336,11 +1368,11 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "Service-specific metadata associated with the operation. It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata. Any method that returns a\nlong-running operation should document the metadata type, if any.", + "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" }, "name": { - "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should be a resource name ending with `operations/{unique_id}`.", + "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" }, "response": { @@ -1348,7 +1380,7 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.", + "description": "The normal response of the operation in case of success. 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" } }, @@ -1363,7 +1395,7 @@ "type": "string" }, "cancelRequested": { - "description": "[Output only] Identifies whether the user has requested cancellation\nof the operation. Operations that have successfully been cancelled\nhave Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.", + "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`.", "type": "boolean" }, "createTime": { @@ -1392,23 +1424,23 @@ "type": "object" }, "Policy": { - "description": "An Identity and Access Management (IAM) policy, which specifies access\ncontrols for Google Cloud resources.\n\n\nA `Policy` is a collection of `bindings`. A `binding` binds one or more\n`members` to a single `role`. Members can be user accounts, service accounts,\nGoogle groups, and domains (such as G Suite). A `role` is a named list of\npermissions; each `role` can be an IAM predefined role or a user-created\ncustom role.\n\nFor some types of Google Cloud resources, a `binding` can also specify a\n`condition`, which is a logical expression that allows access to a resource\nonly if the expression evaluates to `true`. A condition can add constraints\nbased on attributes of the request, the resource, or both. To learn which\nresources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).\n\n**JSON example:**\n\n {\n \"bindings\": [\n {\n \"role\": \"roles/resourcemanager.organizationAdmin\",\n \"members\": [\n \"user:mike@example.com\",\n \"group:admins@example.com\",\n \"domain:google.com\",\n \"serviceAccount:my-project-id@appspot.gserviceaccount.com\"\n ]\n },\n {\n \"role\": \"roles/resourcemanager.organizationViewer\",\n \"members\": [\n \"user:eve@example.com\"\n ],\n \"condition\": {\n \"title\": \"expirable access\",\n \"description\": \"Does not grant access after Sep 2020\",\n \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\",\n }\n }\n ],\n \"etag\": \"BwWWja0YfJA=\",\n \"version\": 3\n }\n\n**YAML example:**\n\n bindings:\n - members:\n - user:mike@example.com\n - group:admins@example.com\n - domain:google.com\n - serviceAccount:my-project-id@appspot.gserviceaccount.com\n role: roles/resourcemanager.organizationAdmin\n - members:\n - user:eve@example.com\n role: roles/resourcemanager.organizationViewer\n condition:\n title: expirable access\n description: Does not grant access after Sep 2020\n expression: request.time < timestamp('2020-10-01T00:00:00.000Z')\n - etag: BwWWja0YfJA=\n - version: 3\n\nFor a description of IAM and its features, see the\n[IAM documentation](https://cloud.google.com/iam/docs/).", + "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` to a single `role`. Members 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 < 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 < 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/).", "id": "Policy", "properties": { "bindings": { - "description": "Associates a list of `members` to a `role`. Optionally, may specify a\n`condition` that determines how and when the `bindings` are applied. Each\nof the `bindings` must contain at least one member.", + "description": "Associates a list of `members` to 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 member.", "items": { "$ref": "Binding" }, "type": "array" }, "etag": { - "description": "`etag` is used for optimistic concurrency control as a way to help\nprevent simultaneous updates of a policy from overwriting each other.\nIt is strongly suggested that systems make use of the `etag` in the\nread-modify-write cycle to perform policy updates in order to avoid race\nconditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems are expected to put that etag in the request to `setIamPolicy` to\nensure that their change will be applied to the same version of the policy.\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.", + "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.", "format": "byte", "type": "string" }, "version": { - "description": "Specifies the format of the policy.\n\nValid values are `0`, `1`, and `3`. Requests that specify an invalid value\nare rejected.\n\nAny operation that affects conditional role bindings must specify version\n`3`. This requirement applies to the following operations:\n\n* Getting a policy that includes a conditional role binding\n* Adding a conditional role binding to a policy\n* Changing a conditional role binding in a policy\n* Removing any role binding, with or without a condition, from a policy\n that includes conditions\n\n**Important:** If you use IAM Conditions, you must include the `etag` field\nwhenever you call `setIamPolicy`. If you omit this field, then IAM allows\nyou to overwrite a version `3` policy with a version `1` policy, and all of\nthe conditions in the version `3` policy are lost.\n\nIf a policy does not include any conditions, operations on that policy may\nspecify any valid version or leave the field unset.\n\nTo learn which resources support conditions in their IAM policies, see the\n[IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "type": "integer" } @@ -1416,31 +1448,31 @@ "type": "object" }, "ReconfigureTrustRequest": { - "description": "Request message for\nReconfigureTrust", + "description": "Request message for ReconfigureTrust", "id": "ReconfigureTrustRequest", "properties": { "targetDnsIpAddresses": { - "description": "Required. The target DNS server IP addresses to resolve the remote domain involved\nin the trust.", + "description": "Required. The target DNS server IP addresses to resolve the remote domain involved in the trust.", "items": { "type": "string" }, "type": "array" }, "targetDomainName": { - "description": "Required. The fully-qualified target domain name which will be in trust with current\ndomain.", + "description": "Required. The fully-qualified target domain name which will be in trust with current domain.", "type": "string" } }, "type": "object" }, "ResetAdminPasswordRequest": { - "description": "Request message for\nResetAdminPassword", + "description": "Request message for ResetAdminPassword", "id": "ResetAdminPasswordRequest", "properties": {}, "type": "object" }, "ResetAdminPasswordResponse": { - "description": "Response message for\nResetAdminPassword", + "description": "Response message for ResetAdminPassword", "id": "ResetAdminPasswordResponse", "properties": { "password": { @@ -1456,13 +1488,13 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An empty policy is a\nvalid policy but certain Cloud Platform services (such as Projects)\nmight reject them." + "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 Cloud Platform services (such as Projects) might reject them." } }, "type": "object" }, "Status": { - "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).", + "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).", "id": "Status", "properties": { "code": { @@ -1471,7 +1503,7 @@ "type": "integer" }, "details": { - "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", @@ -1482,7 +1514,7 @@ "type": "array" }, "message": { - "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", + "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" } }, @@ -1493,7 +1525,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with\nwildcards (such as '*' or 'storage.*') are not allowed. For more\ninformation see\n[IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, @@ -1507,7 +1539,7 @@ "id": "TestIamPermissionsResponse", "properties": { "permissions": { - "description": "A subset of `TestPermissionsRequest.permissions` that the caller is\nallowed.", + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "items": { "type": "string" }, @@ -1517,21 +1549,23 @@ "type": "object" }, "Trust": { - "description": "Represents a relationship between two domains. This allows a controller in\none domain to authenticate a user in another domain.", + "description": "Represents a relationship between two domains. This allows a controller in one domain to authenticate a user in another domain.", "id": "Trust", "properties": { "createTime": { "description": "Output only. The time the instance was created.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "lastTrustHeartbeatTime": { - "description": "Output only. The last heartbeat time when the trust was known to be\nconnected.", + "description": "Output only. The last heartbeat time when the trust was known to be connected.", "format": "google-datetime", + "readOnly": true, "type": "string" }, "selectiveAuthentication": { - "description": "The trust authentication type, which decides whether the trusted side has\nforest/domain wide access or selective access to an approved set of\nresources.", + "description": "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" }, "state": { @@ -1552,25 +1586,27 @@ "The domain trust is connected.", "The domain trust is disconnected." ], + "readOnly": true, "type": "string" }, "stateDescription": { - "description": "Output only. Additional information about the current state of the\ntrust, if available.", + "description": "Output only. Additional information about the current state of the trust, if available.", + "readOnly": true, "type": "string" }, "targetDnsIpAddresses": { - "description": "The target DNS server IP addresses which can resolve the remote domain\ninvolved in the trust.", + "description": "The target DNS server IP addresses which can resolve the remote domain involved in the trust.", "items": { "type": "string" }, "type": "array" }, "targetDomainName": { - "description": "The fully qualified target domain name which will be in trust with the\ncurrent domain.", + "description": "The fully qualified target domain name which will be in trust with the current domain.", "type": "string" }, "trustDirection": { - "description": "The trust direction, which decides if the current domain is trusted,\ntrusting, or both.", + "description": "The trust direction, which decides if the current domain is trusted, trusting, or both.", "enum": [ "TRUST_DIRECTION_UNSPECIFIED", "INBOUND", @@ -1586,7 +1622,7 @@ "type": "string" }, "trustHandshakeSecret": { - "description": "Input only, and will not be stored. The trust secret used for the handshake\nwith the target domain.", + "description": "Input only. The trust secret used for the handshake with the target domain. It will not be stored.", "type": "string" }, "trustType": { @@ -1606,13 +1642,14 @@ "updateTime": { "description": "Output only. The last update time.", "format": "google-datetime", + "readOnly": true, "type": "string" } }, "type": "object" }, "ValidateTrustRequest": { - "description": "Request message for\nValidateTrust", + "description": "Request message for ValidateTrust", "id": "ValidateTrustRequest", "properties": { "trust": { diff --git a/src/apis/managedidentities/v1.ts b/src/apis/managedidentities/v1.ts index 30c60c42973..3cb4273a456 100644 --- a/src/apis/managedidentities/v1.ts +++ b/src/apis/managedidentities/v1.ts @@ -141,11 +141,11 @@ export namespace managedidentities_v1 { */ export interface Schema$Binding { /** - * 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 members 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). + * 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 members 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). */ condition?: Schema$Expr; /** - * Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. + * Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. */ members?: string[] | null; /** @@ -220,11 +220,11 @@ export namespace managedidentities_v1 { updateTime?: string | null; } /** - * 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); } The JSON representation for `Empty` is empty JSON object `{}`. + * 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); } The JSON representation for `Empty` is empty JSON object `{}`. */ export interface Schema$Empty {} /** - * 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() < 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. + * 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() < 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. */ export interface Schema$Expr { /** @@ -361,7 +361,7 @@ export namespace managedidentities_v1 { */ maintenanceSettings?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings; /** - * Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` + * Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` */ name?: string | null; /** @@ -475,7 +475,7 @@ export namespace managedidentities_v1 { */ export interface Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion { /** - * Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be "gaps" in the exclusion application in the exported timeseries. + * Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be "gaps" in the exclusion application in the exported timeseries. */ duration?: string | null; /** @@ -500,7 +500,7 @@ export namespace managedidentities_v1 { */ eligibility?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility; /** - * List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below. + * List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below. */ exclusions?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion[]; /** @@ -508,7 +508,7 @@ export namespace managedidentities_v1 { */ nodes?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata[]; /** - * 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. + * 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. */ tier?: string | null; } @@ -564,7 +564,7 @@ export namespace managedidentities_v1 { */ displayName?: string | null; /** - * Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"} + * Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"} */ labels?: {[key: string]: string} | null; /** @@ -593,7 +593,7 @@ export namespace managedidentities_v1 { */ error?: Schema$Status; /** - * 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. + * 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. */ metadata?: {[key: string]: any} | null; /** @@ -601,7 +601,7 @@ export namespace managedidentities_v1 { */ name?: string | null; /** - * The normal response of the operation in case of success. 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`. + * The normal response of the operation in case of success. 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`. */ response?: {[key: string]: any} | null; } @@ -639,7 +639,7 @@ export namespace managedidentities_v1 { verb?: string | null; } /** - * 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` to a single `role`. Members 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 < 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 < 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/). + * 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` to a single `role`. Members 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 < 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 < 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/). */ export interface Schema$Policy { /** @@ -647,11 +647,11 @@ export namespace managedidentities_v1 { */ bindings?: Schema$Binding[]; /** - * `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. + * `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. */ etag?: string | null; /** - * 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). + * 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). */ version?: number | null; } @@ -691,7 +691,7 @@ export namespace managedidentities_v1 { policy?: Schema$Policy; } /** - * 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). + * 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). */ export interface Schema$Status { /** @@ -699,7 +699,7 @@ export namespace managedidentities_v1 { */ code?: number | null; /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of message types for APIs to use. */ details?: Array<{[key: string]: any}> | null; /** @@ -963,8 +963,7 @@ export namespace managedidentities_v1 { * const res = await managedidentities.projects.locations.list({ * // The standard list filter. * filter: 'placeholder-value', - * // If true, the returned list will include locations which are not yet - * // revealed. + * // If true, the returned list will include locations which are not yet revealed. * includeUnrevealedLocations: 'placeholder-value', * // The resource that owns the locations collection, if applicable. * name: 'projects/my-project', @@ -1166,8 +1165,7 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.attachTrust( * { - * // Required. The resource domain name, project name and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -1313,21 +1311,9 @@ export namespace managedidentities_v1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.create({ - * // 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 segement length (mydomain form example above) shouldn't exceed - * // 15 chars. - * // * The last segment cannot be fully numeric. - * // * Must be unique within the customer project. + * // 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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. * domainName: 'placeholder-value', - * // Required. The resource project name and location using the form: - * // `projects/{project_id}/locations/global` + * // Required. The resource project name and location using the form: `projects/{project_id}/locations/global` * parent: 'projects/my-project/locations/global', * * // Request body metadata @@ -1370,7 +1356,7 @@ export namespace managedidentities_v1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string=} params.domainName 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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. + * @param {string=} params.domainName 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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. * @param {string} params.parent Required. The resource project name and location using the form: `projects/{project_id}/locations/global` * @param {().Domain} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -1484,8 +1470,7 @@ export namespace managedidentities_v1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.delete({ - * // Required. The domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * }); * console.log(res.data); @@ -1619,8 +1604,7 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.detachTrust( * { - * // Required. The resource domain name, project name, and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -1766,8 +1750,7 @@ export namespace managedidentities_v1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.get({ - * // Required. The domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * }); * console.log(res.data); @@ -1908,21 +1891,9 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.getIamPolicy( * { - * // Optional. The policy format version to be returned. - * // - * // Valid values are 0, 1, and 3. Requests specifying an invalid value will be - * // rejected. - * // - * // Requests for policies with any conditional bindings must specify version 3. - * // Policies without any conditional bindings may specify any valid value 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). + * // Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). * 'options.requestedPolicyVersion': 'placeholder-value', - * // REQUIRED: The resource for which the policy is being requested. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * } * ); @@ -1945,7 +1916,7 @@ export namespace managedidentities_v1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {integer=} params.options.requestedPolicyVersion Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). + * @param {integer=} params.options.requestedPolicyVersion Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). * @param {string} params.resource_ REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -2058,26 +2029,15 @@ export namespace managedidentities_v1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.list({ - * // Optional. A filter specifying constraints of a list operation. - * // For example, `Domain.fqdn="mydomain.myorginization"`. + * // Optional. A filter specifying constraints of a list operation. For example, `Domain.fqdn="mydomain.myorginization"`. * filter: 'placeholder-value', - * // Optional. Specifies the ordering of results. See - * // [Sorting - * // order](https://cloud.google.com/apis/design/design_patterns#sorting_order) - * // for more information. + * // Optional. Specifies the ordering of results. See [Sorting order](https://cloud.google.com/apis/design/design_patterns#sorting_order) for more information. * orderBy: 'placeholder-value', - * // 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. + * // 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. * pageSize: 'placeholder-value', - * // Optional. The `next_page_token` value returned from a previous ListDomainsRequest - * // request, if any. + * // Optional. The `next_page_token` value returned from a previous ListDomainsRequest request, if any. * pageToken: 'placeholder-value', - * // Required. The resource name of the domain location using the form: - * // `projects/{project_id}/locations/global` + * // Required. The resource name of the domain location using the form: `projects/{project_id}/locations/global` * parent: 'projects/my-project/locations/global', * }); * console.log(res.data); @@ -2218,15 +2178,9 @@ export namespace managedidentities_v1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.patch({ - * // Required. The unique name of the domain using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}`. + * // Required. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`. * name: 'projects/my-project/locations/global/domains/my-domain', - * // 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` + * // 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` * updateMask: 'placeholder-value', * * // Request body metadata @@ -2270,7 +2224,7 @@ export namespace managedidentities_v1 { * * @param {object} params Parameters for request * @param {string} params.name Required. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`. - * @param {string=} params.updateMask 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` + * @param {string=} params.updateMask 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` * @param {().Domain} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -2381,8 +2335,7 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.reconfigureTrust( * { - * // Required. The resource domain name, project name and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2530,8 +2483,7 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.resetAdminPassword( * { - * // Required. The domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2653,7 +2605,7 @@ export namespace managedidentities_v1 { /** * managedidentities.projects.locations.global.domains.setIamPolicy - * @desc Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * @desc Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. * @example * // Before running the sample: * // - Enable the API at: @@ -2679,8 +2631,7 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.setIamPolicy( * { - * // REQUIRED: The resource for which the policy is being specified. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2799,7 +2750,7 @@ export namespace managedidentities_v1 { /** * managedidentities.projects.locations.global.domains.testIamPermissions - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -2825,8 +2776,7 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.testIamPermissions( * { - * // REQUIRED: The resource for which the policy detail is being requested. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2976,8 +2926,7 @@ export namespace managedidentities_v1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.validateTrust( * { - * // Required. The resource domain name, project name, and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -3112,7 +3061,7 @@ export namespace managedidentities_v1 { export interface Params$Resource$Projects$Locations$Global$Domains$Create extends StandardParameters { /** - * 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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. + * 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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. */ domainName?: string; /** @@ -3154,7 +3103,7 @@ export namespace managedidentities_v1 { export interface Params$Resource$Projects$Locations$Global$Domains$Getiampolicy extends StandardParameters { /** - * Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). + * Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). */ 'options.requestedPolicyVersion'?: number; /** @@ -3192,7 +3141,7 @@ export namespace managedidentities_v1 { */ name?: string; /** - * 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` + * 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` */ updateMask?: string; @@ -3270,7 +3219,7 @@ export namespace managedidentities_v1 { /** * managedidentities.projects.locations.global.operations.cancel - * @desc 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`. + * @desc 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`. * @example * // Before running the sample: * // - Enable the API at: @@ -3535,7 +3484,7 @@ export namespace managedidentities_v1 { /** * managedidentities.projects.locations.global.operations.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -3668,7 +3617,7 @@ export namespace managedidentities_v1 { /** * managedidentities.projects.locations.global.operations.list - * @desc Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/operations"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. + * @desc Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/operations"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. * @example * // Before running the sample: * // - Enable the API at: diff --git a/src/apis/managedidentities/v1alpha1.ts b/src/apis/managedidentities/v1alpha1.ts index 22b633db944..e15d34efb5a 100644 --- a/src/apis/managedidentities/v1alpha1.ts +++ b/src/apis/managedidentities/v1alpha1.ts @@ -138,11 +138,11 @@ export namespace managedidentities_v1alpha1 { */ export interface Schema$Binding { /** - * 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 members 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). + * 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 members 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). */ condition?: Schema$Expr; /** - * Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. + * Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. */ members?: string[] | null; /** @@ -211,11 +211,11 @@ export namespace managedidentities_v1alpha1 { updateTime?: string | null; } /** - * 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); } The JSON representation for `Empty` is empty JSON object `{}`. + * 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); } The JSON representation for `Empty` is empty JSON object `{}`. */ export interface Schema$Empty {} /** - * 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() < 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. + * 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() < 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. */ export interface Schema$Expr { /** @@ -352,7 +352,7 @@ export namespace managedidentities_v1alpha1 { */ maintenanceSettings?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings; /** - * Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` + * Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` */ name?: string | null; /** @@ -466,7 +466,7 @@ export namespace managedidentities_v1alpha1 { */ export interface Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion { /** - * Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be "gaps" in the exclusion application in the exported timeseries. + * Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be "gaps" in the exclusion application in the exported timeseries. */ duration?: string | null; /** @@ -491,7 +491,7 @@ export namespace managedidentities_v1alpha1 { */ eligibility?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility; /** - * List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below. + * List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below. */ exclusions?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion[]; /** @@ -499,7 +499,7 @@ export namespace managedidentities_v1alpha1 { */ nodes?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata[]; /** - * 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. + * 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. */ tier?: string | null; } @@ -552,7 +552,7 @@ export namespace managedidentities_v1alpha1 { */ displayName?: string | null; /** - * Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"} + * Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"} */ labels?: {[key: string]: string} | null; /** @@ -581,7 +581,7 @@ export namespace managedidentities_v1alpha1 { */ error?: Schema$Status; /** - * 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. + * 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. */ metadata?: {[key: string]: any} | null; /** @@ -589,7 +589,7 @@ export namespace managedidentities_v1alpha1 { */ name?: string | null; /** - * The normal response of the operation in case of success. 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`. + * The normal response of the operation in case of success. 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`. */ response?: {[key: string]: any} | null; } @@ -627,7 +627,7 @@ export namespace managedidentities_v1alpha1 { verb?: string | null; } /** - * 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` to a single `role`. Members 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 < 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 < 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/). + * 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` to a single `role`. Members 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 < 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 < 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/). */ export interface Schema$Policy { /** @@ -635,11 +635,11 @@ export namespace managedidentities_v1alpha1 { */ bindings?: Schema$Binding[]; /** - * `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. + * `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. */ etag?: string | null; /** - * 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). + * 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). */ version?: number | null; } @@ -666,7 +666,7 @@ export namespace managedidentities_v1alpha1 { policy?: Schema$Policy; } /** - * 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). + * 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). */ export interface Schema$Status { /** @@ -674,7 +674,7 @@ export namespace managedidentities_v1alpha1 { */ code?: number | null; /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of message types for APIs to use. */ details?: Array<{[key: string]: any}> | null; /** @@ -935,8 +935,7 @@ export namespace managedidentities_v1alpha1 { * const res = await managedidentities.projects.locations.list({ * // The standard list filter. * filter: 'placeholder-value', - * // If true, the returned list will include locations which are not yet - * // revealed. + * // If true, the returned list will include locations which are not yet revealed. * includeUnrevealedLocations: 'placeholder-value', * // The resource that owns the locations collection, if applicable. * name: 'projects/my-project', @@ -1112,7 +1111,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.attachTrust - * @desc Adds AD trust in a given domain. Operation + * @desc Adds AD trust in a given domain. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -1138,8 +1137,7 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.attachTrust( * { - * // The resource domain name, project name and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -1260,7 +1258,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.create - * @desc Creates a Microsoft AD Domain in a given project. Operation + * @desc Creates a Microsoft AD Domain in a given project. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -1285,21 +1283,9 @@ export namespace managedidentities_v1alpha1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.create({ - * // 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. - * // * Must be unique within the project. - * // * First segement length (mydomain form example above) shouldn't exceed - * // 15 chars. - * // * The last segment cannot be fully numeric. + * // 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. * Must be unique within the project. * First segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * domainName: 'placeholder-value', - * // Resource project name and location using the form: - * // `projects/{project_id}/locations/global` + * // Resource project name and location using the form: `projects/{project_id}/locations/global` * parent: 'projects/my-project/locations/global', * * // Request body metadata @@ -1342,7 +1328,7 @@ export namespace managedidentities_v1alpha1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string=} params.domainName 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. * Must be unique within the project. * First segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. + * @param {string=} params.domainName 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. * Must be unique within the project. * First segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * @param {string} params.parent Resource project name and location using the form: `projects/{project_id}/locations/global` * @param {().Domain} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -1431,7 +1417,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.delete - * @desc Deletes identified domain. Operation + * @desc Deletes identified domain. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -1456,8 +1442,7 @@ export namespace managedidentities_v1alpha1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.delete({ - * // Domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * }); * console.log(res.data); @@ -1565,7 +1550,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.detachTrust - * @desc Removes identified trust. Operation + * @desc Removes identified trust. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -1591,8 +1576,7 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.detachTrust( * { - * // The resource domain name, project name, and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -1738,8 +1722,7 @@ export namespace managedidentities_v1alpha1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.get({ - * // Domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * }); * console.log(res.data); @@ -1880,21 +1863,9 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.getIamPolicy( * { - * // Optional. The policy format version to be returned. - * // - * // Valid values are 0, 1, and 3. Requests specifying an invalid value will be - * // rejected. - * // - * // Requests for policies with any conditional bindings must specify version 3. - * // Policies without any conditional bindings may specify any valid value 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). + * // Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). * 'options.requestedPolicyVersion': 'placeholder-value', - * // REQUIRED: The resource for which the policy is being requested. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * } * ); @@ -1917,7 +1888,7 @@ export namespace managedidentities_v1alpha1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {integer=} params.options.requestedPolicyVersion Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). + * @param {integer=} params.options.requestedPolicyVersion Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). * @param {string} params.resource_ REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -2030,22 +2001,15 @@ export namespace managedidentities_v1alpha1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.list({ - * // Optional. Filter specifying constraints of a list operation. - * // For example, `Domain.fqdn="mydomain.myorginization"`. + * // Optional. Filter specifying constraints of a list operation. For example, `Domain.fqdn="mydomain.myorginization"`. * filter: 'placeholder-value', - * // Optional. Specifies the ordering of results following syntax at - * // https://cloud.google.com/apis/design/design_patterns#sorting_order. + * // Optional. Specifies the ordering of results following syntax at https://cloud.google.com/apis/design/design_patterns#sorting_order. * orderBy: 'placeholder-value', - * // 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. + * // 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. * pageSize: 'placeholder-value', * // The next_page_token value returned from a previous List request, if any. * pageToken: 'placeholder-value', - * // Required. The resource name of the domain location using the form: - * // `projects/{project_id}/locations/global` + * // Required. The resource name of the domain location using the form: `projects/{project_id}/locations/global` * parent: 'projects/my-project/locations/global', * }); * console.log(res.data); @@ -2161,7 +2125,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.patch - * @desc Updates the metadata and configuration of a specified domain. Operation + * @desc Updates the metadata and configuration of a specified domain. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -2186,16 +2150,9 @@ export namespace managedidentities_v1alpha1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.patch({ - * // Output only. Unique name of the domain in this scope including projects and - * // location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}`. + * // Output only. Unique name of the domain in this scope including projects and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`. * name: 'projects/my-project/locations/global/domains/my-domain', - * // 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 Domain: - * // * `labels` - * // * `locations` - * // * `authorized_networks` + * // 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 Domain: * `labels` * `locations` * `authorized_networks` * updateMask: 'placeholder-value', * * // Request body metadata @@ -2239,7 +2196,7 @@ export namespace managedidentities_v1alpha1 { * * @param {object} params Parameters for request * @param {string} params.name Output only. Unique name of the domain in this scope including projects and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}`. - * @param {string=} params.updateMask 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 Domain: * `labels` * `locations` * `authorized_networks` + * @param {string=} params.updateMask 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 Domain: * `labels` * `locations` * `authorized_networks` * @param {().Domain} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -2324,7 +2281,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.reconfigureTrust - * @desc Updates the dns conditional forwarder. Operation + * @desc Updates the dns conditional forwarder. Operation * @example * // Before running the sample: * // - Enable the API at: @@ -2350,8 +2307,7 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.reconfigureTrust( * { - * // The resource domain name, project name and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2498,8 +2454,7 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.resetAdminPassword( * { - * // The domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2621,7 +2576,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.setIamPolicy - * @desc Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * @desc Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. * @example * // Before running the sample: * // - Enable the API at: @@ -2647,8 +2602,7 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.setIamPolicy( * { - * // REQUIRED: The resource for which the policy is being specified. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2767,7 +2721,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.testIamPermissions - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -2793,8 +2747,7 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.testIamPermissions( * { - * // REQUIRED: The resource for which the policy detail is being requested. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2918,7 +2871,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.domains.validateTrust - * @desc Validate the trust state Operation + * @desc Validate the trust state Operation * @example * // Before running the sample: * // - Enable the API at: @@ -2944,8 +2897,7 @@ export namespace managedidentities_v1alpha1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.validateTrust( * { - * // The resource domain name, project name, and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -3080,7 +3032,7 @@ export namespace managedidentities_v1alpha1 { export interface Params$Resource$Projects$Locations$Global$Domains$Create extends StandardParameters { /** - * 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. * Must be unique within the project. * First segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. + * 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. * Must be unique within the project. * First segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. */ domainName?: string; /** @@ -3122,7 +3074,7 @@ export namespace managedidentities_v1alpha1 { export interface Params$Resource$Projects$Locations$Global$Domains$Getiampolicy extends StandardParameters { /** - * Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). + * Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). */ 'options.requestedPolicyVersion'?: number; /** @@ -3160,7 +3112,7 @@ export namespace managedidentities_v1alpha1 { */ name?: string; /** - * 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 Domain: * `labels` * `locations` * `authorized_networks` + * 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 Domain: * `labels` * `locations` * `authorized_networks` */ updateMask?: string; @@ -3238,7 +3190,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.operations.cancel - * @desc 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`. + * @desc 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`. * @example * // Before running the sample: * // - Enable the API at: @@ -3506,7 +3458,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.operations.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -3639,7 +3591,7 @@ export namespace managedidentities_v1alpha1 { /** * managedidentities.projects.locations.global.operations.list - * @desc Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/operations"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. + * @desc Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/operations"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. * @example * // Before running the sample: * // - Enable the API at: diff --git a/src/apis/managedidentities/v1beta1.ts b/src/apis/managedidentities/v1beta1.ts index 0928810c962..5e625cd9d9f 100644 --- a/src/apis/managedidentities/v1beta1.ts +++ b/src/apis/managedidentities/v1beta1.ts @@ -141,11 +141,11 @@ export namespace managedidentities_v1beta1 { */ export interface Schema$Binding { /** - * 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 members 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). + * 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 members 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). */ condition?: Schema$Expr; /** - * Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. + * Specifies the identities requesting access for a Cloud Platform 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. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `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. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. */ members?: string[] | null; /** @@ -220,11 +220,11 @@ export namespace managedidentities_v1beta1 { updateTime?: string | null; } /** - * 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); } The JSON representation for `Empty` is empty JSON object `{}`. + * 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); } The JSON representation for `Empty` is empty JSON object `{}`. */ export interface Schema$Empty {} /** - * 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() < 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. + * 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() < 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. */ export interface Schema$Expr { /** @@ -361,7 +361,7 @@ export namespace managedidentities_v1beta1 { */ maintenanceSettings?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings; /** - * Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` + * Unique name of the resource. It uses the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` */ name?: string | null; /** @@ -475,7 +475,7 @@ export namespace managedidentities_v1beta1 { */ export interface Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion { /** - * Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be "gaps" in the exclusion application in the exported timeseries. + * Exclusion duration. No restrictions on the possible values. When an ongoing operation is taking longer than initially expected, an existing entry in the exclusion list can be updated by extending the duration. This is supported by the subsystem exporting eligibility data as long as such extension is committed at least 10 minutes before the original exclusion expiration - otherwise it is possible that there will be "gaps" in the exclusion application in the exported timeseries. */ duration?: string | null; /** @@ -500,7 +500,7 @@ export namespace managedidentities_v1beta1 { */ eligibility?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility; /** - * List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below. + * List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below. */ exclusions?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion[]; /** @@ -508,7 +508,7 @@ export namespace managedidentities_v1beta1 { */ nodes?: Schema$GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata[]; /** - * 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. + * 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. */ tier?: string | null; } @@ -564,7 +564,7 @@ export namespace managedidentities_v1beta1 { */ displayName?: string | null; /** - * Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"} + * Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"} */ labels?: {[key: string]: string} | null; /** @@ -593,7 +593,7 @@ export namespace managedidentities_v1beta1 { */ error?: Schema$Status; /** - * 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. + * 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. */ metadata?: {[key: string]: any} | null; /** @@ -601,7 +601,7 @@ export namespace managedidentities_v1beta1 { */ name?: string | null; /** - * The normal response of the operation in case of success. 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`. + * The normal response of the operation in case of success. 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`. */ response?: {[key: string]: any} | null; } @@ -639,7 +639,7 @@ export namespace managedidentities_v1beta1 { verb?: string | null; } /** - * 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` to a single `role`. Members 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 < 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 < 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/). + * 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` to a single `role`. Members 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 < 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 < 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/). */ export interface Schema$Policy { /** @@ -647,11 +647,11 @@ export namespace managedidentities_v1beta1 { */ bindings?: Schema$Binding[]; /** - * `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. + * `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. */ etag?: string | null; /** - * 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). + * 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). */ version?: number | null; } @@ -691,7 +691,7 @@ export namespace managedidentities_v1beta1 { policy?: Schema$Policy; } /** - * 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). + * 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). */ export interface Schema$Status { /** @@ -699,7 +699,7 @@ export namespace managedidentities_v1beta1 { */ code?: number | null; /** - * A list of messages that carry the error details. There is a common set of message types for APIs to use. + * A list of messages that carry the error details. There is a common set of message types for APIs to use. */ details?: Array<{[key: string]: any}> | null; /** @@ -762,7 +762,7 @@ export namespace managedidentities_v1beta1 { */ trustDirection?: string | null; /** - * Input only, and will not be stored. The trust secret used for the handshake with the target domain. + * Input only. The trust secret used for the handshake with the target domain. It will not be stored. */ trustHandshakeSecret?: string | null; /** @@ -963,8 +963,7 @@ export namespace managedidentities_v1beta1 { * const res = await managedidentities.projects.locations.list({ * // The standard list filter. * filter: 'placeholder-value', - * // If true, the returned list will include locations which are not yet - * // revealed. + * // If true, the returned list will include locations which are not yet revealed. * includeUnrevealedLocations: 'placeholder-value', * // The resource that owns the locations collection, if applicable. * name: 'projects/my-project', @@ -1166,8 +1165,7 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.attachTrust( * { - * // Required. The resource domain name, project name and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -1313,19 +1311,9 @@ export namespace managedidentities_v1beta1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.create({ - * // Required. A domain name, e.g. mydomain.myorg.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 segement length (mydomain form example above) shouldn't exceed - * // 15 chars. - * // * The last segment cannot be fully numeric. - * // * Must be unique within the customer project. + * // Required. A domain name, e.g. mydomain.myorg.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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. * domainName: 'placeholder-value', - * // Required. The resource project name and location using the form: - * // `projects/{project_id}/locations/global` + * // Required. The resource project name and location using the form: `projects/{project_id}/locations/global` * parent: 'projects/my-project/locations/global', * * // Request body metadata @@ -1368,7 +1356,7 @@ export namespace managedidentities_v1beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {string=} params.domainName Required. A domain name, e.g. mydomain.myorg.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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. + * @param {string=} params.domainName Required. A domain name, e.g. mydomain.myorg.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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. * @param {string} params.parent Required. The resource project name and location using the form: `projects/{project_id}/locations/global` * @param {().Domain} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. @@ -1482,8 +1470,7 @@ export namespace managedidentities_v1beta1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.delete({ - * // Required. The domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * }); * console.log(res.data); @@ -1617,8 +1604,7 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.detachTrust( * { - * // Required. The resource domain name, project name, and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -1764,8 +1750,7 @@ export namespace managedidentities_v1beta1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.get({ - * // Required. The domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * }); * console.log(res.data); @@ -1906,21 +1891,9 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.getIamPolicy( * { - * // Optional. The policy format version to be returned. - * // - * // Valid values are 0, 1, and 3. Requests specifying an invalid value will be - * // rejected. - * // - * // Requests for policies with any conditional bindings must specify version 3. - * // Policies without any conditional bindings may specify any valid value 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). + * // Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). * 'options.requestedPolicyVersion': 'placeholder-value', - * // REQUIRED: The resource for which the policy is being requested. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * } * ); @@ -1943,7 +1916,7 @@ export namespace managedidentities_v1beta1 { * @memberOf! () * * @param {object} params Parameters for request - * @param {integer=} params.options.requestedPolicyVersion Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). + * @param {integer=} params.options.requestedPolicyVersion Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). * @param {string} params.resource_ REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -2056,26 +2029,15 @@ export namespace managedidentities_v1beta1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.list({ - * // Optional. A filter specifying constraints of a list operation. - * // For example, `Domain.fqdn="mydomain.myorginization"`. + * // Optional. A filter specifying constraints of a list operation. For example, `Domain.fqdn="mydomain.myorginization"`. * filter: 'placeholder-value', - * // Optional. Specifies the ordering of results. See - * // [Sorting - * // order](https://cloud.google.com/apis/design/design_patterns#sorting_order) - * // for more information. + * // Optional. Specifies the ordering of results. See [Sorting order](https://cloud.google.com/apis/design/design_patterns#sorting_order) for more information. * orderBy: 'placeholder-value', - * // 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. + * // 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. * pageSize: 'placeholder-value', - * // The `next_page_token` value returned from a previous ListDomainsRequest - * // request, if any. + * // The `next_page_token` value returned from a previous ListDomainsRequest request, if any. * pageToken: 'placeholder-value', - * // Required. The resource name of the domain location using the form: - * // `projects/{project_id}/locations/global` + * // Required. The resource name of the domain location using the form: `projects/{project_id}/locations/global` * parent: 'projects/my-project/locations/global', * }); * console.log(res.data); @@ -2216,15 +2178,9 @@ export namespace managedidentities_v1beta1 { * * // Do the magic * const res = await managedidentities.projects.locations.global.domains.patch({ - * // Output only. The unique name of the domain using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}`. + * // Output only. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`. * name: 'projects/my-project/locations/global/domains/my-domain', - * // 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` + * // 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` * updateMask: 'placeholder-value', * * // Request body metadata @@ -2268,7 +2224,7 @@ export namespace managedidentities_v1beta1 { * * @param {object} params Parameters for request * @param {string} params.name Output only. The unique name of the domain using the form: `projects/{project_id}/locations/global/domains/{domain_name}`. - * @param {string=} params.updateMask 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` + * @param {string=} params.updateMask 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` * @param {().Domain} params.requestBody Request body data * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`. * @param {callback} callback The callback that handles the response. @@ -2379,8 +2335,7 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.reconfigureTrust( * { - * // Required. The resource domain name, project name and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2528,8 +2483,7 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.resetAdminPassword( * { - * // Required. The domain resource name using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The domain resource name using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2651,7 +2605,7 @@ export namespace managedidentities_v1beta1 { /** * managedidentities.projects.locations.global.domains.setIamPolicy - * @desc Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * @desc Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. * @example * // Before running the sample: * // - Enable the API at: @@ -2677,8 +2631,7 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.setIamPolicy( * { - * // REQUIRED: The resource for which the policy is being specified. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2797,7 +2750,7 @@ export namespace managedidentities_v1beta1 { /** * managedidentities.projects.locations.global.domains.testIamPermissions - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -2823,8 +2776,7 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.testIamPermissions( * { - * // REQUIRED: The resource for which the policy detail is being requested. - * // See the operation documentation for the appropriate value for this field. + * // REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. * resource: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -2974,8 +2926,7 @@ export namespace managedidentities_v1beta1 { * // Do the magic * const res = await managedidentities.projects.locations.global.domains.validateTrust( * { - * // Required. The resource domain name, project name, and location using the form: - * // `projects/{project_id}/locations/global/domains/{domain_name}` + * // Required. The resource domain name, project name, and location using the form: `projects/{project_id}/locations/global/domains/{domain_name}` * name: 'projects/my-project/locations/global/domains/my-domain', * * // Request body metadata @@ -3110,7 +3061,7 @@ export namespace managedidentities_v1beta1 { export interface Params$Resource$Projects$Locations$Global$Domains$Create extends StandardParameters { /** - * Required. A domain name, e.g. mydomain.myorg.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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. + * Required. A domain name, e.g. mydomain.myorg.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 segement length (mydomain form example above) shouldn't exceed 15 chars. * The last segment cannot be fully numeric. * Must be unique within the customer project. */ domainName?: string; /** @@ -3152,7 +3103,7 @@ export namespace managedidentities_v1beta1 { export interface Params$Resource$Projects$Locations$Global$Domains$Getiampolicy extends StandardParameters { /** - * Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). + * Optional. The policy format version to be returned. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value 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). */ 'options.requestedPolicyVersion'?: number; /** @@ -3190,7 +3141,7 @@ export namespace managedidentities_v1beta1 { */ name?: string; /** - * 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` + * 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` */ updateMask?: string; @@ -3268,7 +3219,7 @@ export namespace managedidentities_v1beta1 { /** * managedidentities.projects.locations.global.operations.cancel - * @desc 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`. + * @desc 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`. * @example * // Before running the sample: * // - Enable the API at: @@ -3536,7 +3487,7 @@ export namespace managedidentities_v1beta1 { /** * managedidentities.projects.locations.global.operations.get - * @desc 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. + * @desc 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. * @example * // Before running the sample: * // - Enable the API at: @@ -3669,7 +3620,7 @@ export namespace managedidentities_v1beta1 { /** * managedidentities.projects.locations.global.operations.list - * @desc Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/operations"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. + * @desc Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/x/operations`. To override the binding, API services can add a binding such as `"/v1/{name=users/x}/operations"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id. * @example * // Before running the sample: * // - Enable the API at: