{ "mtlsRootUrl": "https://redis.mtls.googleapis.com/", "description": "Creates and manages Redis instances on the Google Cloud Platform.", "kind": "discovery#restDescription", "ownerDomain": "google.com", "schemas": { "BackupConfiguration": { "id": "BackupConfiguration", "type": "object", "properties": { "backupRetentionSettings": { "description": "Backup retention settings.", "$ref": "RetentionSettings" }, "automatedBackupEnabled": { "type": "boolean", "description": "Whether customer visible automated backups are enabled on the instance." }, "pointInTimeRecoveryEnabled": { "type": "boolean", "description": "Whether point-in-time recovery is enabled. This is optional field, if the database service does not have this feature or metadata is not available in control plane, this can be omitted." } }, "description": "Configuration for automatic backups" }, "GcsBackupSource": { "id": "GcsBackupSource", "type": "object", "properties": { "uris": { "type": "array", "description": "Optional. URIs of the Cloud Storage objects to import. Example: gs://bucket1/object1, gs://bucket2/folder2/object2", "items": { "type": "string" } } }, "description": "Backups stored in Cloud Storage buckets. The Cloud Storage buckets need to be the same region as the clusters." }, "MaintenancePolicy": { "id": "MaintenancePolicy", "type": "object", "properties": { "description": { "description": "Optional. Description of what this policy is for. Create/Update methods return INVALID_ARGUMENT if the length is greater than 512.", "type": "string" }, "weeklyMaintenanceWindow": { "description": "Optional. Maintenance window that is applied to resources covered by this policy. Minimum 1. For the current version, the maximum number of weekly_window is expected to be one.", "items": { "$ref": "WeeklyMaintenanceWindow" }, "type": "array" }, "createTime": { "type": "string", "description": "Output only. The time when the policy was created.", "format": "google-datetime", "readOnly": true }, "updateTime": { "readOnly": true, "type": "string", "description": "Output only. The time when the policy was last updated.", "format": "google-datetime" } }, "description": "Maintenance policy for an instance." }, "UserLabels": { "type": "object", "properties": { "labels": { "additionalProperties": { "type": "string" }, "type": "object" } }, "description": "Message type for storing user labels. User labels are used to tag App Engine resources, allowing users to search for resources matching a set of labels and to aggregate usage data by labels.", "id": "UserLabels" }, "SignalMetadata": { "description": "SignalMetadata contains one of the signal metadata proto messages associated with a SignalType. This proto will be mapped to SignalMetadata message in storage.proto. Next ID: 3", "type": "object", "properties": { "signalBoolValue": { "type": "boolean", "description": "Signal data for boolean signals." }, "backupRun": { "$ref": "BackupRun", "description": "Signal data for backup runs." } }, "id": "SignalMetadata" }, "MachineConfiguration": { "id": "MachineConfiguration", "description": "MachineConfiguration describes the configuration of a machine specific to Database Resource.", "type": "object", "properties": { "maxReservationSlots": { "type": "string", "description": "Optional. Max slots for BigQuery Reservations. Max slots are in increments of 50.", "format": "int64" }, "shardCount": { "type": "integer", "description": "Optional. Number of shards (if applicable).", "format": "int32" }, "cpuCount": { "description": "The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482) add proto validations again after bug fix.", "deprecated": true, "format": "int32", "type": "integer" }, "vcpuCount": { "description": "Optional. The number of vCPUs. TODO(b/342344482) add proto validations again after bug fix.", "format": "double", "type": "number" }, "memorySizeInBytes": { "type": "string", "description": "Memory size in bytes. TODO(b/342344482) add proto validations again after bug fix.", "format": "int64" }, "baselineSlots": { "type": "string", "description": "Optional. Baseline slots for BigQuery Reservations. Baseline slots are in increments of 50.", "format": "int64" } } }, "Empty": { "id": "Empty", "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "type": "object", "properties": {} }, "Entitlement": { "description": "Proto representing the access that a user has to a specific feature/service. NextId: 3.", "type": "object", "properties": { "type": { "description": "An enum that represents the type of this entitlement.", "type": "string", "enumDeprecated": [ false, true, false, false ], "enum": [ "ENTITLEMENT_TYPE_UNSPECIFIED", "GEMINI", "NATIVE", "GCA_STANDARD" ], "enumDescriptions": [ "The entitlement type is unspecified.", "The root entitlement representing Gemini package ownership.This will no longer be supported in the future.", "The entitlement representing Native Tier, This will be the default Entitlement going forward with GCA Enablement.", "The entitlement representing GCA-Standard Tier." ] }, "entitlementState": { "description": "The current state of user's accessibility to a feature/benefit.", "type": "string", "enumDescriptions": [ "", "User is entitled to a feature/benefit, but whether it has been successfully provisioned is decided by provisioning state.", "User is entitled to a feature/benefit, but it was requested to be revoked. Whether the revoke has been successful is decided by provisioning state." ], "enum": [ "ENTITLEMENT_STATE_UNSPECIFIED", "ENTITLED", "REVOKED" ] } }, "id": "Entitlement" }, "RegionalManagedCertificateAuthority": { "id": "RegionalManagedCertificateAuthority", "description": "CA certificate chains for redis managed server authentication.", "type": "object", "properties": { "caCerts": { "type": "array", "description": "The PEM encoded CA certificate chains for redis managed server authentication", "items": { "$ref": "RegionalCertChain" } } } }, "Date": { "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "type": "object", "properties": { "year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "format": "int32", "type": "integer" }, "month": { "type": "integer", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "format": "int32" }, "day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "format": "int32", "type": "integer" } }, "id": "Date" }, "RDBConfig": { "type": "object", "properties": { "rdbSnapshotPeriod": { "enumDescriptions": [ "Not set.", "One hour.", "Six hours.", "Twelve hours.", "Twenty four hours." ], "enum": [ "SNAPSHOT_PERIOD_UNSPECIFIED", "ONE_HOUR", "SIX_HOURS", "TWELVE_HOURS", "TWENTY_FOUR_HOURS" ], "type": "string", "description": "Optional. Period between RDB snapshots." }, "rdbSnapshotStartTime": { "description": "Optional. The time that the first snapshot was/will be attempted, and to which future snapshots will be aligned. If not provided, the current time will be used.", "format": "google-datetime", "type": "string" } }, "description": "Configuration of the RDB based persistence.", "id": "RDBConfig" }, "StateInfo": { "id": "StateInfo", "description": "Represents additional information about the state of the cluster.", "type": "object", "properties": { "updateInfo": { "description": "Describes ongoing update on the cluster when cluster state is UPDATING.", "$ref": "UpdateInfo" } } }, "RescheduleMaintenanceRequest": { "id": "RescheduleMaintenanceRequest", "description": "Request for RescheduleMaintenance.", "type": "object", "properties": { "rescheduleType": { "enumDescriptions": [ "Not set.", "If the user wants to schedule the maintenance to happen now.", "If the user wants to use the existing maintenance policy to find the next available window.", "If the user wants to reschedule the maintenance to a specific time." ], "enum": [ "RESCHEDULE_TYPE_UNSPECIFIED", "IMMEDIATE", "NEXT_AVAILABLE_WINDOW", "SPECIFIC_TIME" ], "description": "Required. If reschedule type is SPECIFIC_TIME, must set up schedule_time as well.", "type": "string" }, "scheduleTime": { "type": "string", "description": "Optional. Timestamp when the maintenance shall be rescheduled to if reschedule_type=SPECIFIC_TIME, in RFC 3339 format, for example `2012-11-15T16:19:00.094Z`.", "format": "google-datetime" } } }, "ExportBackupRequest": { "id": "ExportBackupRequest", "type": "object", "properties": { "gcsBucket": { "type": "string", "description": "Google Cloud Storage bucket, like \"my-bucket\"." } }, "description": "Request for `ExportBackup`." }, "AOFConfig": { "description": "Configuration of the AOF based persistence.", "type": "object", "properties": { "appendFsync": { "enumDescriptions": [ "Not set. Default: EVERYSEC", "Never fsync. Normally Linux will flush data every 30 seconds with this configuration, but it's up to the kernel's exact tuning.", "fsync every second. Fast enough, and you may lose 1 second of data if there is a disaster", "fsync every time new write commands are appended to the AOF. It has the best data loss protection at the cost of performance" ], "enum": [ "APPEND_FSYNC_UNSPECIFIED", "NO", "EVERYSEC", "ALWAYS" ], "type": "string", "description": "Optional. fsync configuration." } }, "id": "AOFConfig" }, "ListBackupsResponse": { "id": "ListBackupsResponse", "type": "object", "properties": { "unreachable": { "type": "array", "description": "Backups that could not be reached.", "items": { "type": "string" } }, "backups": { "description": "A list of backups in the project.", "items": { "$ref": "Backup" }, "type": "array" }, "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, "description": "Response for `ListBackups`." }, "GCBDRConfiguration": { "description": "GCBDR Configuration for the resource.", "type": "object", "properties": { "gcbdrManaged": { "type": "boolean", "description": "Whether the resource is managed by GCBDR." } }, "id": "GCBDRConfiguration" }, "AclRule": { "id": "AclRule", "type": "object", "properties": { "username": { "type": "string", "description": "Required. Specifies the IAM user or service account to be added to the ACL policy. This username will be directly set on the Redis OSS." }, "rule": { "description": "Required. The rule to be applied to the username. Ex: \"on \u003epassword123 ~* +@all\" The format of the rule is defined by Redis OSS: https://redis.io/docs/latest/operate/oss_and_stack/management/security/acl/", "type": "string" } }, "description": "A single ACL rule which defines the policy for a user." }, "DatabaseResourceMetadata": { "id": "DatabaseResourceMetadata", "type": "object", "properties": { "resourceFlags": { "description": "Optional. List of resource flags for the database resource.", "items": { "$ref": "ResourceFlags" }, "type": "array" }, "expectedState": { "description": "The state that the instance is expected to be in. For example, an instance state can transition to UNHEALTHY due to wrong patch update, while the expected state will remain at the HEALTHY.", "type": "string", "enumDescriptions": [ "", "The instance is running.", "Instance being created, updated, deleted or under maintenance", "When instance is suspended", "Instance is deleted.", "For rest of the other category", "Instance is in STOPPED state." ], "enum": [ "STATE_UNSPECIFIED", "HEALTHY", "UNHEALTHY", "SUSPENDED", "DELETED", "STATE_OTHER", "STOPPED" ] }, "creationTime": { "type": "string", "description": "The creation time of the resource, i.e. the time when resource is created and recorded in partner service.", "format": "google-datetime" }, "customMetadata": { "description": "Any custom metadata associated with the resource", "$ref": "CustomMetadataData" }, "userLabelSet": { "$ref": "UserLabels", "description": "User-provided labels associated with the resource" }, "zone": { "type": "string", "description": "The resource zone. This is only applicable for zonal resources and will be empty for regional and multi-regional resources." }, "updationTime": { "type": "string", "description": "The time at which the resource was updated and recorded at partner service.", "format": "google-datetime" }, "resourceContainer": { "description": "Closest parent Cloud Resource Manager container of this resource. It must be resource name of a Cloud Resource Manager project with the format of \"/\", such as \"projects/123\". For GCP provided resources, number should be project number.", "type": "string" }, "availabilityConfiguration": { "description": "Availability configuration for this instance", "$ref": "AvailabilityConfiguration" }, "entitlements": { "type": "array", "description": "Entitlements associated with the resource", "items": { "$ref": "Entitlement" } }, "id": { "description": "Required. Unique identifier for a Database resource", "$ref": "DatabaseResourceId" }, "backupRun": { "$ref": "BackupRun", "description": "Latest backup run information for this instance" }, "backupdrConfiguration": { "description": "Optional. BackupDR Configuration for the resource.", "$ref": "BackupDRConfiguration" }, "isDeletionProtectionEnabled": { "description": "Optional. Whether deletion protection is enabled for this resource.", "type": "boolean" }, "suspensionReason": { "enumDescriptions": [ "Suspension reason is unspecified.", "Wipeout hide event.", "Wipeout purge event.", "Billing disabled for project", "Abuse detected for resource", "Encryption key inaccessible.", "Replicated cluster encryption key inaccessible." ], "enum": [ "SUSPENSION_REASON_UNSPECIFIED", "WIPEOUT_HIDE_EVENT", "WIPEOUT_PURGE_EVENT", "BILLING_DISABLED", "ABUSER_DETECTED", "ENCRYPTION_KEY_INACCESSIBLE", "REPLICATED_CLUSTER_ENCRYPTION_KEY_INACCESSIBLE" ], "type": "string", "description": "Optional. Suspension reason for the resource." }, "gcbdrConfiguration": { "description": "GCBDR configuration for the resource.", "deprecated": true, "$ref": "GCBDRConfiguration" }, "machineConfiguration": { "$ref": "MachineConfiguration", "description": "Machine configuration for this resource." }, "modes": { "description": "Optional. The modes of the database resource.", "items": { "enumDescriptions": [ "Default mode.", "Native mode.", "MongoDB compatible mode.", "Datastore mode." ], "enum": [ "MODE_UNSPECIFIED", "MODE_NATIVE", "MODE_MONGODB_COMPATIBLE", "MODE_DATASTORE" ], "type": "string" }, "type": "array" }, "primaryResourceLocation": { "description": "Primary resource location. REQUIRED if the immediate parent exists when first time resource is getting ingested, otherwise optional.", "type": "string" }, "backupConfiguration": { "$ref": "BackupConfiguration", "description": "Backup configuration for this instance" }, "product": { "$ref": "Product", "description": "The product this resource represents." }, "currentState": { "enumDescriptions": [ "", "The instance is running.", "Instance being created, updated, deleted or under maintenance", "When instance is suspended", "Instance is deleted.", "For rest of the other category", "Instance is in STOPPED state." ], "enum": [ "STATE_UNSPECIFIED", "HEALTHY", "UNHEALTHY", "SUSPENDED", "DELETED", "STATE_OTHER", "STOPPED" ], "description": "Current state of the instance.", "type": "string" }, "instanceType": { "enumDescriptions": [ "Unspecified.", "For rest of the other categories.", "A regular primary database instance.", "A cluster or an instance acting as a secondary.", "An instance acting as a read-replica.", "For rest of the other categories.", "A regular primary database instance.", "A cluster or an instance acting as a secondary.", "An instance acting as a read-replica.", "An instance acting as an external primary.", "An instance acting as Read Pool.", "Represents a reservation resource.", "Represents a dataset resource.", "For rest of the other categories." ], "enum": [ "INSTANCE_TYPE_UNSPECIFIED", "SUB_RESOURCE_TYPE_UNSPECIFIED", "PRIMARY", "SECONDARY", "READ_REPLICA", "OTHER", "SUB_RESOURCE_TYPE_PRIMARY", "SUB_RESOURCE_TYPE_SECONDARY", "SUB_RESOURCE_TYPE_READ_REPLICA", "SUB_RESOURCE_TYPE_EXTERNAL_PRIMARY", "SUB_RESOURCE_TYPE_READ_POOL", "SUB_RESOURCE_TYPE_RESERVATION", "SUB_RESOURCE_TYPE_DATASET", "SUB_RESOURCE_TYPE_OTHER" ], "description": "The type of the instance. Specified at creation time.", "type": "string", "enumDeprecated": [ true, false, true, true, true, true, false, false, false, false, false, false, false, false ] }, "tagsSet": { "description": "Optional. Tags associated with this resources.", "$ref": "Tags" }, "location": { "description": "The resource location. REQUIRED", "type": "string" }, "resourceName": { "description": "Required. Different from DatabaseResourceId.unique_id, a resource name can be reused over time. That is, after a resource named \"ABC\" is deleted, the name \"ABC\" can be used to to create a new resource within the same source. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", "type": "string" }, "edition": { "enumDescriptions": [ "Default, to make it consistent with instance edition enum.", "Represents the enterprise edition.", "Represents the enterprise plus edition.", "Represents the standard edition." ], "enum": [ "EDITION_UNSPECIFIED", "EDITION_ENTERPRISE", "EDITION_ENTERPRISE_PLUS", "EDITION_STANDARD" ], "type": "string", "description": "Optional. Edition represents whether the instance is ENTERPRISE or ENTERPRISE_PLUS. This information is core to Cloud SQL only and is used to identify the edition of the instance." }, "maintenanceInfo": { "$ref": "ResourceMaintenanceInfo", "description": "Optional. Maintenance info for the resource." }, "primaryResourceId": { "description": "Identifier for this resource's immediate parent/primary resource if the current resource is a replica or derived form of another Database resource. Else it would be NULL. REQUIRED if the immediate parent exists when first time resource is getting ingested, otherwise optional.", "$ref": "DatabaseResourceId" } }, "description": "Common model for database resource instance metadata. Next ID: 32" }, "ResourceFlags": { "type": "object", "properties": { "key": { "type": "string", "description": "Optional. Key of the resource flag." }, "value": { "type": "string", "description": "Optional. Value of the resource flag." } }, "description": "Message type for storing resource flags.", "id": "ResourceFlags" }, "WeeklyMaintenanceWindow": { "id": "WeeklyMaintenanceWindow", "type": "object", "properties": { "startTime": { "description": "Required. Start time of the window in UTC time.", "$ref": "TimeOfDay" }, "day": { "description": "Required. The day of week that maintenance updates occur.", "type": "string", "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ] }, "duration": { "readOnly": true, "description": "Output only. Duration of the maintenance window. The current window is fixed at 1 hour.", "format": "google-duration", "type": "string" } }, "description": "Time window in which disruptive maintenance updates occur. Non-disruptive updates can occur inside or outside this window." }, "TimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "type": "object", "properties": { "minutes": { "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "seconds": { "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32", "type": "integer" }, "hours": { "type": "integer", "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "format": "int32" }, "nanos": { "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" } }, "id": "TimeOfDay" }, "ClusterPersistenceConfig": { "id": "ClusterPersistenceConfig", "description": "Configuration of the persistence functionality.", "type": "object", "properties": { "aofConfig": { "$ref": "AOFConfig", "description": "Optional. AOF configuration. This field will be ignored if mode is not AOF." }, "mode": { "description": "Optional. The mode of persistence.", "type": "string", "enumDescriptions": [ "Not set.", "Persistence is disabled, and any snapshot data is deleted.", "RDB based persistence is enabled.", "AOF based persistence is enabled." ], "enum": [ "PERSISTENCE_MODE_UNSPECIFIED", "DISABLED", "RDB", "AOF" ] }, "rdbConfig": { "$ref": "RDBConfig", "description": "Optional. RDB configuration. This field will be ignored if mode is not RDB." } } }, "ResourceMaintenanceInfo": { "id": "ResourceMaintenanceInfo", "description": "MaintenanceInfo to capture the maintenance details of database resource.", "type": "object", "properties": { "maintenanceVersion": { "type": "string", "description": "Optional. Current Maintenance version of the database resource. Example: \"MYSQL_8_0_41.R20250531.01_15\"" }, "upcomingMaintenance": { "$ref": "UpcomingMaintenance", "description": "Optional. Upcoming maintenance for the database resource. This field is populated once SLM generates and publishes upcoming maintenance window." }, "denyMaintenanceSchedules": { "description": "Optional. List of Deny maintenance period for the database resource.", "items": { "$ref": "ResourceMaintenanceDenySchedule" }, "type": "array" }, "maintenanceState": { "description": "Output only. Current state of maintenance on the database resource.", "type": "string", "enum": [ "MAINTENANCE_STATE_UNSPECIFIED", "CREATING", "READY", "UPDATING", "REPAIRING", "DELETING", "ERROR" ], "readOnly": true, "enumDescriptions": [ "Unspecified state.", "Database resource is being created.", "Database resource has been created and is ready to use.", "Database resource is being updated.", "Database resource is unheathy and under repair.", "Database resource is being deleted.", "Database resource encountered an error and is in indeterministic state." ] }, "maintenanceSchedule": { "description": "Optional. Maintenance window for the database resource.", "$ref": "ResourceMaintenanceSchedule" }, "currentVersionReleaseDate": { "description": "Optional. The date when the current maintenance version was released.", "$ref": "Date" }, "isInstanceStopped": { "type": "boolean", "description": "Optional. Whether the instance is in stopped state. This information is temporarily being captured in maintenanceInfo, till STOPPED state is supported by DB Center." } } }, "ListAuthTokensResponse": { "id": "ListAuthTokensResponse", "description": "Response message for ListAuthTokens.", "type": "object", "properties": { "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "authTokens": { "type": "array", "description": "A list of auth tokens in the project.", "items": { "$ref": "AuthToken" } }, "unreachable": { "type": "array", "description": "Unordered list. Auth tokens that could not be reached.", "items": { "type": "string" } } } }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "type": "object", "properties": { "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "format": "int32", "type": "integer" }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "type": "array" }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" } }, "id": "Status" }, "CertChain": { "type": "object", "properties": { "certificates": { "type": "array", "description": "The certificates that form the CA chain, from leaf to root order.", "items": { "type": "string" } } }, "id": "CertChain" }, "RetentionSettings": { "id": "RetentionSettings", "type": "object", "properties": { "timestampBasedRetentionTime": { "type": "string", "description": "Timestamp based retention period i.e. 2024-05-01T00:00:00Z", "format": "google-datetime" }, "quantityBasedRetention": { "type": "integer", "format": "int32" }, "durationBasedRetention": { "description": "Duration based retention period i.e. 172800 seconds (2 days)", "format": "google-duration", "type": "string" }, "retentionUnit": { "deprecated": true, "enumDescriptions": [ "Backup retention unit is unspecified, will be treated as COUNT.", "Retention will be by count, eg. \"retain the most recent 7 backups\".", "Retention will be by Time, eg. \"retain backups till a specific time\" i.e. till 2024-05-01T00:00:00Z.", "Retention will be by duration, eg. \"retain the backups for 172800 seconds (2 days)\".", "For rest of the other category" ], "type": "string", "description": "The unit that 'retained_backups' represents.", "enum": [ "RETENTION_UNIT_UNSPECIFIED", "COUNT", "TIME", "DURATION", "RETENTION_UNIT_OTHER" ] }, "timeBasedRetention": { "type": "string", "deprecated": true, "format": "google-duration" } } }, "UpgradeInstanceRequest": { "type": "object", "properties": { "redisVersion": { "description": "Required. Specifies the target version of Redis software to upgrade to.", "type": "string" } }, "description": "Request for UpgradeInstance.", "id": "UpgradeInstanceRequest" }, "ListLocationsResponse": { "type": "object", "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "items": { "$ref": "Location" }, "type": "array" }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "description": "The response message for Locations.ListLocations.", "id": "ListLocationsResponse" }, "ListInstancesResponse": { "id": "ListInstancesResponse", "description": "Response for ListInstances.", "type": "object", "properties": { "unreachable": { "description": "Locations that could not be reached.", "items": { "type": "string" }, "type": "array" }, "instances": { "type": "array", "description": "A list of Redis instances in the project in the specified location, or across all locations. If the `location_id` in the parent field of the request is \"-\", all regions available to the project are queried, and the results aggregated. If in such an aggregated query a location is unavailable, a placeholder Redis entry is included in the response with the `name` field set to a value of the form `projects/{project_id}/locations/{location_id}/instances/`- and the `status` field set to ERROR and `status_message` field set to \"location not available for ListInstances\".", "items": { "$ref": "Instance" } }, "nextPageToken": { "type": "string", "description": "Token to retrieve the next page of results, or empty if there are no more results in the list." } } }, "SharedRegionalCertificateAuthority": { "type": "object", "properties": { "managedServerCa": { "description": "CA certificate chains for redis managed server authentication.", "$ref": "RegionalManagedCertificateAuthority" }, "name": { "type": "string", "description": "Identifier. Unique name of the resource in this scope including project and location using the form: `projects/{project}/locations/{location}/sharedRegionalCertificateAuthority`" } }, "description": "Shared regional certificate authority", "id": "SharedRegionalCertificateAuthority" }, "OperationMetadata": { "id": "OperationMetadata", "description": "Pre-defined metadata fields.", "type": "object", "properties": { "target": { "readOnly": true, "type": "string", "description": "Output only. Server-defined resource path for the target of the operation." }, "requestedCancellation": { "readOnly": true, "type": "boolean", "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`." }, "verb": { "readOnly": true, "description": "Output only. Name of the verb executed by the operation.", "type": "string" }, "apiVersion": { "description": "Output only. API version used to start the operation.", "type": "string", "readOnly": true }, "endTime": { "type": "string", "description": "Output only. The time the operation finished running.", "format": "google-datetime", "readOnly": true }, "statusMessage": { "type": "string", "description": "Output only. Human-readable status of the operation, if any.", "readOnly": true }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. The time the operation was created.", "format": "google-datetime" } } }, "DiscoveryEndpoint": { "description": "Endpoints on each network, for Redis clients to connect to the cluster.", "type": "object", "properties": { "pscConfig": { "description": "Output only. Customer configuration for where the endpoint is created and accessed from.", "readOnly": true, "$ref": "PscConfig" }, "address": { "description": "Output only. Address of the exposed Redis endpoint used by clients to connect to the service. The address could be either IP or hostname.", "type": "string", "readOnly": true }, "port": { "description": "Output only. The port number of the exposed Redis endpoint.", "format": "int32", "type": "integer", "readOnly": true } }, "id": "DiscoveryEndpoint" }, "AddTokenAuthUserRequest": { "type": "object", "properties": { "tokenAuthUser": { "type": "string", "description": "Required. The id of the token auth user to add." } }, "description": "Request message for AddTokenAuthUser.", "id": "AddTokenAuthUserRequest" }, "ReconciliationOperationMetadata": { "type": "object", "properties": { "deleteResource": { "type": "boolean", "description": "DEPRECATED. Use exclusive_action instead.", "deprecated": true }, "exclusiveAction": { "enumDescriptions": [ "Unknown repair action.", "The resource has to be deleted. When using this bit, the CLH should fail the operation. DEPRECATED. Instead use DELETE_RESOURCE OperationSignal in SideChannel.", "This resource could not be repaired but the repair should be tried again at a later time. This can happen if there is a dependency that needs to be resolved first- e.g. if a parent resource must be repaired before a child resource." ], "description": "Excluisive action returned by the CLH.", "type": "string", "enumDeprecated": [ false, true, false ], "enum": [ "UNKNOWN_REPAIR_ACTION", "DELETE", "RETRY" ] } }, "description": "Operation metadata returned by the CLH during resource state reconciliation.", "id": "ReconciliationOperationMetadata" }, "EncryptionInfo": { "description": "EncryptionInfo describes the encryption information of a cluster or a backup.", "type": "object", "properties": { "kmsKeyVersions": { "description": "Output only. KMS key versions that are being used to protect the data at-rest.", "items": { "type": "string" }, "type": "array", "readOnly": true }, "lastUpdateTime": { "readOnly": true, "type": "string", "description": "Output only. The most recent time when the encryption info was updated.", "format": "google-datetime" }, "encryptionType": { "enumDescriptions": [ "Encryption type not specified. Defaults to GOOGLE_DEFAULT_ENCRYPTION.", "The data is encrypted at rest with a key that is fully managed by Google. No key version will be populated. This is the default state.", "The data is encrypted at rest with a key that is managed by the customer. KMS key versions will be populated." ], "readOnly": true, "enum": [ "TYPE_UNSPECIFIED", "GOOGLE_DEFAULT_ENCRYPTION", "CUSTOMER_MANAGED_ENCRYPTION" ], "type": "string", "description": "Output only. Type of encryption." }, "kmsKeyPrimaryState": { "type": "string", "description": "Output only. The state of the primary version of the KMS key perceived by the system. This field is not populated in backups.", "readOnly": true, "enum": [ "KMS_KEY_STATE_UNSPECIFIED", "ENABLED", "PERMISSION_DENIED", "DISABLED", "DESTROYED", "DESTROY_SCHEDULED", "EKM_KEY_UNREACHABLE_DETECTED", "BILLING_DISABLED", "UNKNOWN_FAILURE" ], "enumDescriptions": [ "The default value. This value is unused.", "The KMS key is enabled and correctly configured.", "Permission denied on the KMS key.", "The KMS key is disabled.", "The KMS key is destroyed.", "The KMS key is scheduled to be destroyed.", "The EKM key is unreachable.", "Billing is disabled for the project.", "All other unknown failures." ] } }, "id": "EncryptionInfo" }, "ConnectionDetail": { "id": "ConnectionDetail", "type": "object", "properties": { "pscConnection": { "$ref": "PscConnection", "description": "Detailed information of a PSC connection that is created by the customer who owns the cluster." }, "pscAutoConnection": { "$ref": "PscAutoConnection", "description": "Detailed information of a PSC connection that is created through service connectivity automation." } }, "description": "Detailed information of each PSC connection." }, "CrossClusterReplicationConfig": { "type": "object", "properties": { "clusterRole": { "description": "Output only. The role of the cluster in cross cluster replication.", "type": "string", "enum": [ "CLUSTER_ROLE_UNSPECIFIED", "NONE", "PRIMARY", "SECONDARY" ], "readOnly": true, "enumDescriptions": [ "Cluster role is not set. The behavior is equivalent to NONE.", "This cluster does not participate in cross cluster replication. It is an independent cluster and does not replicate to or from any other clusters.", "A cluster that allows both reads and writes. Any data written to this cluster is also replicated to the attached secondary clusters.", "A cluster that allows only reads and replicates data from a primary cluster." ] }, "primaryCluster": { "description": "Details of the primary cluster that is used as the replication source for this secondary cluster. This field is only set for a secondary cluster.", "$ref": "RemoteCluster" }, "membership": { "readOnly": true, "$ref": "Membership", "description": "Output only. An output only view of all the member clusters participating in the cross cluster replication. This view will be provided by every member cluster irrespective of its cluster role(primary or secondary). A primary cluster can provide information about all the secondary clusters replicating from it. However, a secondary cluster only knows about the primary cluster from which it is replicating. However, for scenarios, where the primary cluster is unavailable(e.g. regional outage), a GetCluster request can be sent to any other member cluster and this field will list all the member clusters participating in cross cluster replication." }, "updateTime": { "description": "Output only. The last time cross cluster replication config was updated.", "format": "google-datetime", "type": "string", "readOnly": true }, "secondaryClusters": { "description": "List of secondary clusters that are replicating from this primary cluster. This field is only set for a primary cluster.", "items": { "$ref": "RemoteCluster" }, "type": "array" } }, "description": "Cross cluster replication config.", "id": "CrossClusterReplicationConfig" }, "ConfigBasedSignalData": { "id": "ConfigBasedSignalData", "description": "Config based signal data. This is used to send signals to Condor which are based on the DB level configurations. These will be used to send signals for self managed databases.", "type": "object", "properties": { "resourceId": { "$ref": "DatabaseResourceId", "description": "Database resource id." }, "fullResourceName": { "type": "string", "description": "Required. Full Resource name of the source resource." }, "lastRefreshTime": { "description": "Required. Last time signal was refreshed", "format": "google-datetime", "type": "string" }, "signalBoolValue": { "description": "Signal data for boolean signals.", "type": "boolean" }, "signalType": { "enumDescriptions": [ "Unspecified signal type.", "Outdated Minor Version", "Represents database auditing is disabled.", "Represents if a database has a password configured for the root account or not.", "Represents if a resource is exposed to public access.", "Represents if a resources requires all incoming connections to use SSL or not.", "Represents if a resource version is in extended support.", "Represents if a resource has no automated backup policy.", "Represents if a resource version is nearing end of life.", "Represents if the last backup of a resource is older than 24 hours.", "Represents if a resource is not protected by automatic failover." ], "enum": [ "SIGNAL_TYPE_UNSPECIFIED", "SIGNAL_TYPE_OUTDATED_MINOR_VERSION", "SIGNAL_TYPE_DATABASE_AUDITING_DISABLED", "SIGNAL_TYPE_NO_ROOT_PASSWORD", "SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", "SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS", "SIGNAL_TYPE_EXTENDED_SUPPORT", "SIGNAL_TYPE_NO_AUTOMATED_BACKUP_POLICY", "SIGNAL_TYPE_VERSION_NEARING_END_OF_LIFE", "SIGNAL_TYPE_LAST_BACKUP_OLD", "SIGNAL_TYPE_NOT_PROTECTED_BY_AUTOMATIC_FAILOVER" ], "type": "string", "description": "Required. Signal type of the signal" } } }, "Product": { "description": "Product specification for Condor resources.", "type": "object", "properties": { "type": { "enum": [ "PRODUCT_TYPE_UNSPECIFIED", "PRODUCT_TYPE_CLOUD_SQL", "CLOUD_SQL", "PRODUCT_TYPE_ALLOYDB", "ALLOYDB", "PRODUCT_TYPE_SPANNER", "PRODUCT_TYPE_ON_PREM", "ON_PREM", "PRODUCT_TYPE_MEMORYSTORE", "PRODUCT_TYPE_BIGTABLE", "PRODUCT_TYPE_FIRESTORE", "PRODUCT_TYPE_COMPUTE_ENGINE", "PRODUCT_TYPE_ORACLE_ON_GCP", "PRODUCT_TYPE_BIGQUERY", "PRODUCT_TYPE_OTHER" ], "description": "Type of specific database product. It could be CloudSQL, AlloyDB etc..", "type": "string", "enumDeprecated": [ false, false, true, false, true, false, false, true, false, false, false, false, false, false, false ], "enumDescriptions": [ "UNSPECIFIED means product type is not known or available.", "Cloud SQL product area in GCP", "Cloud SQL product area in GCP", "AlloyDB product area in GCP", "AlloyDB product area in GCP", "Spanner product area in GCP", "On premises database product.", "On premises database product.", "Memorystore product area in GCP", "Bigtable product area in GCP", "Firestore product area in GCP.", "Compute Engine self managed databases", "Oracle product area in GCP", "BigQuery product area in GCP", "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum." ] }, "engine": { "enum": [ "ENGINE_UNSPECIFIED", "ENGINE_MYSQL", "MYSQL", "ENGINE_POSTGRES", "POSTGRES", "ENGINE_SQL_SERVER", "SQL_SERVER", "ENGINE_NATIVE", "NATIVE", "ENGINE_CLOUD_SPANNER_WITH_POSTGRES_DIALECT", "ENGINE_CLOUD_SPANNER_WITH_GOOGLESQL_DIALECT", "ENGINE_MEMORYSTORE_FOR_REDIS", "ENGINE_MEMORYSTORE_FOR_REDIS_CLUSTER", "ENGINE_OTHER", "ENGINE_FIRESTORE_WITH_NATIVE_MODE", "ENGINE_FIRESTORE_WITH_DATASTORE_MODE", "ENGINE_FIRESTORE_WITH_MONGODB_COMPATIBILITY_MODE", "ENGINE_EXADATA_ORACLE", "ENGINE_ADB_SERVERLESS_ORACLE" ], "type": "string", "enumDeprecated": [ false, false, true, false, true, false, true, false, true, false, false, false, false, false, false, false, false, false, false ], "description": "The specific engine that the underlying database is running.", "enumDescriptions": [ "UNSPECIFIED means engine type is not known or available.", "MySQL binary running as an engine in the database instance.", "MySQL binary running as engine in database instance.", "Postgres binary running as engine in database instance.", "Postgres binary running as engine in database instance.", "SQLServer binary running as engine in database instance.", "SQLServer binary running as engine in database instance.", "Native database binary running as engine in instance.", "Native database binary running as engine in instance.", "Cloud Spanner with PostgreSQL dialect.", "Cloud Spanner with Google SQL dialect.", "Memorystore with Redis dialect.", "Memorystore with Redis cluster dialect.", "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", "Firestore with native mode.", "Firestore with datastore mode.", "Firestore with MongoDB compatibility mode.", "Oracle Exadata engine.", "Oracle Autonomous DB Serverless engine." ] }, "minorVersion": { "type": "string", "description": "Minor version of the underlying database engine. Example values: For MySQL, it could be \"8.0.32\", \"5.7.32\" etc.. For Postgres, it could be \"14.3\", \"15.3\" etc.." }, "version": { "description": "Version of the underlying database engine. Example values: For MySQL, it could be \"8.0\", \"5.7\" etc.. For Postgres, it could be \"14\", \"15\" etc..", "type": "string" } }, "id": "Product" }, "RescheduleClusterMaintenanceRequest": { "id": "RescheduleClusterMaintenanceRequest", "type": "object", "properties": { "rescheduleType": { "description": "Required. If reschedule type is SPECIFIC_TIME, must set up schedule_time as well.", "type": "string", "enumDescriptions": [ "Not set.", "If the user wants to schedule the maintenance to happen now.", "If the user wants to reschedule the maintenance to a specific time." ], "enum": [ "RESCHEDULE_TYPE_UNSPECIFIED", "IMMEDIATE", "SPECIFIC_TIME" ] }, "scheduleTime": { "type": "string", "description": "Optional. Timestamp when the maintenance shall be rescheduled to if reschedule_type=SPECIFIC_TIME, in RFC 3339 format, for example `2012-11-15T16:19:00.094Z`.", "format": "google-datetime" } }, "description": "Request for rescheduling a cluster maintenance." }, "BackupFile": { "description": "Backup is consisted of multiple backup files.", "type": "object", "properties": { "createTime": { "readOnly": true, "description": "Output only. The time when the backup file was created.", "format": "google-datetime", "type": "string" }, "fileName": { "readOnly": true, "type": "string", "description": "Output only. e.g: .rdb" }, "sizeBytes": { "readOnly": true, "type": "string", "description": "Output only. Size of the backup file in bytes.", "format": "int64" } }, "id": "BackupFile" }, "ClusterMaintenancePolicy": { "id": "ClusterMaintenancePolicy", "description": "Maintenance policy per cluster.", "type": "object", "properties": { "updateTime": { "readOnly": true, "type": "string", "description": "Output only. The time when the policy was updated i.e. Maintenance Window or Deny Period was updated.", "format": "google-datetime" }, "weeklyMaintenanceWindow": { "type": "array", "description": "Optional. Maintenance window that is applied to resources covered by this policy. Minimum 1. For the current version, the maximum number of weekly_maintenance_window is expected to be one.", "items": { "$ref": "ClusterWeeklyMaintenanceWindow" } }, "createTime": { "readOnly": true, "description": "Output only. The time when the policy was created i.e. Maintenance Window or Deny Period was assigned.", "format": "google-datetime", "type": "string" } } }, "ClusterEndpoint": { "type": "object", "properties": { "connections": { "description": "Required. A group of PSC connections. They are created in the same VPC network, one for each service attachment in the cluster.", "items": { "$ref": "ConnectionDetail" }, "type": "array" } }, "description": "ClusterEndpoint consists of PSC connections that are created as a group in each VPC network for accessing the cluster. In each group, there shall be one connection for each service attachment in the cluster.", "id": "ClusterEndpoint" }, "DatabaseResourceSignalData": { "type": "object", "properties": { "lastRefreshTime": { "type": "string", "description": "Required. Last time signal was refreshed", "format": "google-datetime" }, "location": { "type": "string", "description": "Required. Resource location." }, "backupRun": { "description": "Deprecated: Use signal_metadata_list instead.", "deprecated": true, "$ref": "BackupRun" }, "resourceId": { "description": "Database resource id.", "$ref": "DatabaseResourceId" }, "fullResourceName": { "description": "Required. Full Resource name of the source resource.", "type": "string" }, "signalMetadataList": { "description": "This will support array of OneOf signal metadata information for a given signal type.", "items": { "$ref": "SignalMetadata" }, "type": "array" }, "signalType": { "description": "Required. Signal type of the signal", "type": "string", "enumDescriptions": [ "Unspecified signal type.", "Outdated Minor Version", "Represents database auditing is disabled.", "Represents if a database has a password configured for the root account or not.", "Represents if a resource is exposed to public access.", "Represents if a resources requires all incoming connections to use SSL or not.", "Represents if a resource version is in extended support.", "Represents if a resource has no automated backup policy.", "Represents if a resource version is nearing end of life.", "Represents if the last backup of a resource is older than 24 hours.", "Represents if a resource is not protected by automatic failover." ], "enum": [ "SIGNAL_TYPE_UNSPECIFIED", "SIGNAL_TYPE_OUTDATED_MINOR_VERSION", "SIGNAL_TYPE_DATABASE_AUDITING_DISABLED", "SIGNAL_TYPE_NO_ROOT_PASSWORD", "SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", "SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS", "SIGNAL_TYPE_EXTENDED_SUPPORT", "SIGNAL_TYPE_NO_AUTOMATED_BACKUP_POLICY", "SIGNAL_TYPE_VERSION_NEARING_END_OF_LIFE", "SIGNAL_TYPE_LAST_BACKUP_OLD", "SIGNAL_TYPE_NOT_PROTECTED_BY_AUTOMATIC_FAILOVER" ] }, "signalState": { "enumDescriptions": [ "Unspecified signal state.", "Signal is active and requires attention.", "Signal is inactive and does not require attention.", "Signal is dismissed by the user and should not be shown to the user again." ], "enum": [ "SIGNAL_STATE_UNSPECIFIED", "ACTIVE", "INACTIVE", "DISMISSED" ], "readOnly": true, "description": "Required. Output only. Signal state of the signal", "type": "string" }, "signalBoolValue": { "description": "Deprecated: Use signal_metadata_list instead.", "deprecated": true, "type": "boolean" } }, "description": "Database resource signal data. This is used to send signals to Condor which are based on the DB/Instance/Fleet level configurations. These will be used to send signals for all inventory types. Next ID: 10", "id": "DatabaseResourceSignalData" }, "FailoverInstanceRequest": { "id": "FailoverInstanceRequest", "description": "Request for Failover.", "type": "object", "properties": { "dataProtectionMode": { "enumDescriptions": [ "Defaults to LIMITED_DATA_LOSS if a data protection mode is not specified.", "Instance failover will be protected with data loss control. More specifically, the failover will only be performed if the current replication offset diff between primary and replica is under a certain threshold.", "Instance failover will be performed without data loss control." ], "enum": [ "DATA_PROTECTION_MODE_UNSPECIFIED", "LIMITED_DATA_LOSS", "FORCE_DATA_LOSS" ], "type": "string", "description": "Optional. Available data protection modes that the user can choose. If it's unspecified, data protection mode will be LIMITED_DATA_LOSS by default." } } }, "AuthToken": { "type": "object", "properties": { "name": { "description": "Identifier. Name of the auth token. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}/authTokens/{auth_token}", "type": "string" }, "token": { "readOnly": true, "type": "string", "description": "Output only. The service generated authentication token used to connect to the Redis cluster." }, "createTime": { "type": "string", "description": "Output only. Create time of the auth token.", "format": "google-datetime", "readOnly": true }, "state": { "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "DELETING" ], "readOnly": true, "description": "Output only. State of the auth token.", "type": "string", "enumDescriptions": [ "Not set.", "The auth token is active.", "The auth token is being created.", "The auth token is being deleted." ] } }, "description": "Auth token for the cluster.", "id": "AuthToken" }, "UpcomingMaintenance": { "description": "Upcoming maintenance for the database resource. This is generated by SLM once the upcoming maintenance schedule is published.", "type": "object", "properties": { "startTime": { "type": "string", "description": "Optional. The start time of the upcoming maintenance.", "format": "google-datetime" }, "endTime": { "description": "Optional. The end time of the upcoming maintenance.", "format": "google-datetime", "type": "string" } }, "id": "UpcomingMaintenance" }, "ManagedBackupSource": { "description": "Backups that generated and managed by memorystore.", "type": "object", "properties": { "backup": { "type": "string", "description": "Optional. Example: //redis.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} A shorter version (without the prefix) of the backup name is also supported, like projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup_id} In this case, it assumes the backup is under redis.googleapis.com." } }, "id": "ManagedBackupSource" }, "BackupDRMetadata": { "type": "object", "properties": { "resourceId": { "$ref": "DatabaseResourceId", "description": "Required. Database resource id." }, "lastRefreshTime": { "description": "Required. Last time backup configuration was refreshed.", "format": "google-datetime", "type": "string" }, "backupConfiguration": { "$ref": "BackupConfiguration", "description": "Backup configuration for this instance." }, "fullResourceName": { "type": "string", "description": "Required. Full resource name of this instance." }, "backupRun": { "description": "Latest backup run information for this instance.", "$ref": "BackupRun" }, "backupdrConfiguration": { "description": "BackupDR configuration for this instance.", "$ref": "BackupDRConfiguration" } }, "description": "BackupDRMetadata contains information about the backup and disaster recovery metadata of a database resource.", "id": "BackupDRMetadata" }, "ListBackupCollectionsResponse": { "id": "ListBackupCollectionsResponse", "type": "object", "properties": { "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "backupCollections": { "type": "array", "description": "A list of backupCollections in the project. If the `location_id` in the parent field of the request is \"-\", all regions available to the project are queried, and the results aggregated. If in such an aggregated query a location is unavailable, a placeholder backupCollection entry is included in the response with the `name` field set to a value of the form `projects/{project_id}/locations/{location_id}/backupCollections/`- and the `status` field set to ERROR and `status_message` field set to \"location not available for ListBackupCollections\".", "items": { "$ref": "BackupCollection" } }, "unreachable": { "type": "array", "description": "Locations that could not be reached.", "items": { "type": "string" } } }, "description": "Response for `ListBackupCollections`." }, "BackupDRConfiguration": { "id": "BackupDRConfiguration", "description": "BackupDRConfiguration to capture the backup and disaster recovery details of database resource.", "type": "object", "properties": { "backupdrManaged": { "type": "boolean", "description": "Indicates if the resource is managed by BackupDR." } } }, "ExportInstanceRequest": { "description": "Request for Export.", "type": "object", "properties": { "outputConfig": { "description": "Required. Specify data to be exported.", "$ref": "OutputConfig" } }, "id": "ExportInstanceRequest" }, "InstanceAuthString": { "id": "InstanceAuthString", "type": "object", "properties": { "authString": { "type": "string", "description": "AUTH string set on the instance." } }, "description": "Instance AUTH string details." }, "ListTokenAuthUsersResponse": { "description": "Response message for ListTokenAuthUsers.", "type": "object", "properties": { "tokenAuthUsers": { "description": "A list of token auth users in the project.", "items": { "$ref": "TokenAuthUser" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "Token to retrieve the next page of results, or empty if there are no more results in the list." }, "unreachable": { "type": "array", "description": "Unordered list. Token auth users that could not be reached.", "items": { "type": "string" } } }, "id": "ListTokenAuthUsersResponse" }, "MaintenanceSchedule": { "id": "MaintenanceSchedule", "description": "Upcoming maintenance schedule. If no maintenance is scheduled, fields are not populated.", "type": "object", "properties": { "scheduleDeadlineTime": { "readOnly": true, "description": "Output only. The deadline that the maintenance schedule start time can not go beyond, including reschedule.", "format": "google-datetime", "type": "string" }, "startTime": { "type": "string", "description": "Output only. The start time of any upcoming scheduled maintenance for this instance.", "format": "google-datetime", "readOnly": true }, "canReschedule": { "description": "If the scheduled maintenance can be rescheduled, default is true.", "deprecated": true, "type": "boolean" }, "endTime": { "description": "Output only. The end time of any upcoming scheduled maintenance for this instance.", "format": "google-datetime", "type": "string", "readOnly": true } } }, "ListAclPoliciesResponse": { "description": "Response for `ListAclPolicies`.", "type": "object", "properties": { "aclPolicies": { "type": "array", "description": "A list of ACL policies in the project in the specified location, or across all locations. If the `location_id` in the parent field of the request is \"-\", all regions available to the project are queried, and the results aggregated.", "items": { "$ref": "AclPolicy" } }, "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "unreachable": { "type": "array", "description": "Locations that could not be reached.", "items": { "type": "string" } } }, "id": "ListAclPoliciesResponse" }, "GoogleCloudCommonOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "type": "object", "properties": { "target": { "readOnly": true, "description": "Output only. Server-defined resource path for the target of the operation.", "type": "string" }, "verb": { "readOnly": true, "description": "Output only. Name of the verb executed by the operation.", "type": "string" }, "apiVersion": { "readOnly": true, "description": "Output only. API version used to start the operation.", "type": "string" }, "statusDetail": { "type": "string", "description": "Output only. Human-readable status of the operation, if any.", "readOnly": true }, "cancelRequested": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "type": "boolean", "readOnly": true }, "endTime": { "readOnly": true, "type": "string", "description": "Output only. The time the operation finished running.", "format": "google-datetime" }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. The time the operation was created.", "format": "google-datetime" } }, "id": "GoogleCloudCommonOperationMetadata" }, "Instance": { "id": "Instance", "description": "A Memorystore for Redis instance.", "type": "object", "properties": { "replicaCount": { "description": "Optional. The number of replica nodes. The valid range for the Standard Tier with read replicas enabled is [1-5] and defaults to 2. If read replicas are not enabled for a Standard Tier instance, the only valid value is 1 and the default is 1. The valid value for basic tier is 0 and the default is also 0.", "format": "int32", "type": "integer" }, "authorizedNetwork": { "description": "Optional. The full name of the Google Compute Engine [network](https://cloud.google.com/vpc/docs/vpc) to which the instance is connected. If left unspecified, the `default` network will be used.", "type": "string" }, "labels": { "type": "object", "description": "Resource labels to represent user provided metadata", "additionalProperties": { "type": "string" } }, "redisConfigs": { "type": "object", "description": "Optional. Redis configuration parameters, according to [Redis configuration](https://redis.io/docs/latest/operate/oss_and_stack/management/config/). Currently, the only supported parameters are: Redis version 3.2 and newer: * maxmemory-policy * notify-keyspace-events Redis version 4.0 and newer: * activedefrag * lfu-decay-time * lfu-log-factor * maxmemory-gb Redis version 5.0 and newer: * stream-node-max-bytes * stream-node-max-entries", "additionalProperties": { "type": "string" } }, "statusMessage": { "description": "Output only. Additional information about the current status of this instance, if available.", "type": "string", "readOnly": true }, "serverCaCerts": { "description": "Output only. List of server CA certificates for the instance.", "items": { "$ref": "TlsCertificate" }, "type": "array", "readOnly": true }, "state": { "enumDescriptions": [ "Not set.", "Redis instance is being created.", "Redis instance has been created and is fully usable.", "Redis instance configuration is being updated. Certain kinds of updates may cause the instance to become unusable while the update is in progress.", "Redis instance is being deleted.", "Redis instance is being repaired and may be unusable.", "Maintenance is being performed on this Redis instance.", "Redis instance is importing data (availability may be affected).", "Redis instance is failing over (availability may be affected)." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "READY", "UPDATING", "DELETING", "REPAIRING", "MAINTENANCE", "IMPORTING", "FAILING_OVER" ], "readOnly": true, "description": "Output only. The current state of this instance.", "type": "string" }, "locationId": { "type": "string", "description": "Optional. The zone where the instance will be provisioned. If not provided, the service will choose a zone from the specified region for the instance. For standard tier, additional nodes will be added across multiple zones for protection against zonal failures. If specified, at least one node will be provisioned in this zone." }, "maintenanceVersion": { "description": "Optional. The self service update maintenance version. The version is date based such as \"20210712_00_00\".", "type": "string" }, "host": { "description": "Output only. Hostname or IP address of the exposed Redis endpoint used by clients to connect to the service.", "type": "string", "readOnly": true }, "authEnabled": { "description": "Optional. Indicates whether OSS Redis AUTH is enabled for the instance. If set to \"true\" AUTH is enabled on the instance. Default value is \"false\" meaning AUTH is disabled.", "type": "boolean" }, "redisVersion": { "type": "string", "description": "Optional. The version of Redis software. If not provided, latest supported version will be used. Currently, the supported values are: * `REDIS_3_2` for Redis 3.2 compatibility * `REDIS_4_0` for Redis 4.0 compatibility (default) * `REDIS_5_0` for Redis 5.0 compatibility * `REDIS_6_X` for Redis 6.x compatibility * `REDIS_7_0` for Redis 7.0 compatibility" }, "maintenanceSchedule": { "description": "Output only. Date and time of upcoming maintenance events which have been scheduled.", "readOnly": true, "$ref": "MaintenanceSchedule" }, "suspensionReasons": { "description": "Optional. reasons that causes instance in \"SUSPENDED\" state.", "items": { "enumDescriptions": [ "Not set.", "Something wrong with the CMEK key provided by customer." ], "enum": [ "SUSPENSION_REASON_UNSPECIFIED", "CUSTOMER_MANAGED_KEY_ISSUE" ], "type": "string" }, "type": "array" }, "alternativeLocationId": { "type": "string", "description": "Optional. If specified, at least one node will be provisioned in this zone in addition to the zone specified in location_id. Only applicable to standard tier. If provided, it must be a different zone from the one provided in [location_id]. Additional nodes beyond the first 2 will be placed in zones selected by the service." }, "nodes": { "readOnly": true, "description": "Output only. Info per node.", "items": { "$ref": "NodeInfo" }, "type": "array" }, "readEndpoint": { "readOnly": true, "type": "string", "description": "Output only. Hostname or IP address of the exposed readonly Redis endpoint. Standard tier only. Targets all healthy replica nodes in instance. Replication is asynchronous and replica nodes will exhibit some lag behind the primary. Write requests must target 'host'." }, "tags": { "type": "object", "description": "Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"", "additionalProperties": { "type": "string" } }, "maintenancePolicy": { "$ref": "MaintenancePolicy", "description": "Optional. The maintenance policy for the instance. If not provided, maintenance events can be performed at any time." }, "satisfiesPzi": { "description": "Optional. Output only. Reserved for future use.", "type": "boolean", "readOnly": true }, "tier": { "type": "string", "description": "Required. The service tier of the instance.", "enumDescriptions": [ "Not set.", "BASIC tier: standalone instance", "STANDARD_HA tier: highly available primary/replica instances" ], "enum": [ "TIER_UNSPECIFIED", "BASIC", "STANDARD_HA" ] }, "secondaryIpRange": { "type": "string", "description": "Optional. Additional IP range for node placement. Required when enabling read replicas on an existing instance. For DIRECT_PEERING mode value must be a CIDR range of size /28, or \"auto\". For PRIVATE_SERVICE_ACCESS mode value must be the name of an allocated address range associated with the private service access connection, or \"auto\"." }, "createTime": { "description": "Output only. The time the instance was created.", "format": "google-datetime", "type": "string", "readOnly": true }, "readReplicasMode": { "description": "Optional. Read replicas mode for the instance. Defaults to READ_REPLICAS_DISABLED.", "type": "string", "enumDescriptions": [ "If not set, Memorystore Redis backend will default to READ_REPLICAS_DISABLED.", "If disabled, read endpoint will not be provided and the instance cannot scale up or down the number of replicas.", "If enabled, read endpoint will be provided and the instance can scale up and down the number of replicas. Not valid for basic tier." ], "enum": [ "READ_REPLICAS_MODE_UNSPECIFIED", "READ_REPLICAS_DISABLED", "READ_REPLICAS_ENABLED" ] }, "memorySizeGb": { "type": "integer", "description": "Required. Redis memory size in GiB.", "format": "int32" }, "connectMode": { "type": "string", "description": "Optional. The network connect mode of the Redis instance. If not provided, the connect mode defaults to DIRECT_PEERING.", "enumDescriptions": [ "Not set.", "Connect via direct peering to the Memorystore for Redis hosted service.", "Connect your Memorystore for Redis instance using Private Service Access. Private services access provides an IP address range for multiple Google Cloud services, including Memorystore." ], "enum": [ "CONNECT_MODE_UNSPECIFIED", "DIRECT_PEERING", "PRIVATE_SERVICE_ACCESS" ] }, "name": { "description": "Required. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` Note: Redis instances are managed and addressed at regional level so location_id here refers to a GCP region; however, users may choose which specific zone (or collection of zones for cross-zone instances) an instance should be provisioned in. Refer to location_id and alternative_location_id fields for more details.", "type": "string" }, "readEndpointPort": { "readOnly": true, "type": "integer", "description": "Output only. The port number of the exposed readonly redis endpoint. Standard tier only. Write requests should target 'port'.", "format": "int32" }, "reservedIpRange": { "type": "string", "description": "Optional. For DIRECT_PEERING mode, the CIDR range of internal addresses that are reserved for this instance. Range must be unique and non-overlapping with existing subnets in an authorized network. For PRIVATE_SERVICE_ACCESS mode, the name of one allocated IP address ranges associated with this private service access connection. If not provided, the service will choose an unused /29 block, for example, 10.0.0.0/29 or 192.168.0.0/29. For READ_REPLICAS_ENABLED the default block size is /28." }, "port": { "type": "integer", "description": "Output only. The port number of the exposed Redis endpoint.", "format": "int32", "readOnly": true }, "satisfiesPzs": { "type": "boolean", "description": "Optional. Output only. Reserved for future use.", "readOnly": true }, "persistenceIamIdentity": { "description": "Output only. Cloud IAM identity used by import / export operations to transfer data to/from Cloud Storage. Format is \"serviceAccount:\". The value may change over time for a given instance so should be checked before each import/export operation.", "type": "string", "readOnly": true }, "transitEncryptionMode": { "enumDescriptions": [ "Not set.", "Client to Server traffic encryption enabled with server authentication.", "TLS is disabled for the instance." ], "enum": [ "TRANSIT_ENCRYPTION_MODE_UNSPECIFIED", "SERVER_AUTHENTICATION", "DISABLED" ], "type": "string", "description": "Optional. The TLS mode of the Redis instance. If not provided, TLS is disabled for the instance." }, "persistenceConfig": { "description": "Optional. Persistence configuration parameters", "$ref": "PersistenceConfig" }, "currentLocationId": { "type": "string", "description": "Output only. The current zone where the Redis primary node is located. In basic tier, this will always be the same as [location_id]. In standard tier, this can be the zone of any node in the instance.", "readOnly": true }, "availableMaintenanceVersions": { "type": "array", "description": "Optional. The available maintenance versions that an instance could update to.", "items": { "type": "string" } }, "customerManagedKey": { "description": "Optional. The KMS key reference that the customer provides when trying to create the instance.", "type": "string" }, "displayName": { "description": "An arbitrary and optional user-provided name for the instance.", "type": "string" } } }, "GcsSource": { "type": "object", "properties": { "uri": { "description": "Required. Source data URI. (e.g. 'gs://my_bucket/my_object').", "type": "string" } }, "description": "The Cloud Storage location for the input content", "id": "GcsSource" }, "AvailabilityConfiguration": { "description": "Configuration for availability of database instance", "type": "object", "properties": { "automaticFailoverRoutingConfigured": { "type": "boolean", "description": "Checks for existence of (multi-cluster) routing configuration that allows automatic failover to a different zone/region in case of an outage. Applicable to Bigtable resources." }, "crossRegionReplicaConfigured": { "type": "boolean", "description": "Checks for resources that are configured to have redundancy, and ongoing replication across regions" }, "externalReplicaConfigured": { "type": "boolean" }, "promotableReplicaConfigured": { "type": "boolean" }, "availabilityType": { "type": "string", "description": "Availability type. Potential values: * `ZONAL`: The instance serves data from only one zone. Outages in that zone affect data accessibility. * `REGIONAL`: The instance can serve data from more than one zone in a region (it is highly available).", "enumDescriptions": [ "", "Zonal available instance.", "Regional available instance.", "Multi regional instance", "For rest of the other category" ], "enum": [ "AVAILABILITY_TYPE_UNSPECIFIED", "ZONAL", "REGIONAL", "MULTI_REGIONAL", "AVAILABILITY_TYPE_OTHER" ] } }, "id": "AvailabilityConfiguration" }, "TypedValue": { "id": "TypedValue", "type": "object", "properties": { "int64Value": { "description": "For integer value", "format": "int64", "type": "string" }, "doubleValue": { "type": "number", "description": "For double value", "format": "double" }, "stringValue": { "type": "string", "description": "For string value" }, "boolValue": { "description": "For boolean value", "type": "boolean" } }, "description": "TypedValue represents the value of a metric type. It can either be a double, an int64, a string or a bool." }, "BackupCollection": { "description": "BackupCollection of a cluster.", "type": "object", "properties": { "uid": { "type": "string", "description": "Output only. System assigned unique identifier of the backup collection.", "readOnly": true }, "cluster": { "type": "string", "description": "Output only. The full resource path of the cluster the backup collection belongs to. Example: projects/{project}/locations/{location}/clusters/{cluster}", "readOnly": true }, "createTime": { "readOnly": true, "description": "Output only. The time when the backup collection was created.", "format": "google-datetime", "type": "string" }, "totalBackupSizeBytes": { "type": "string", "description": "Output only. Total size of all backups in the backup collection.", "format": "int64", "readOnly": true }, "totalBackupCount": { "readOnly": true, "type": "string", "description": "Output only. Total number of backups in the backup collection.", "format": "int64" }, "clusterUid": { "type": "string", "description": "Output only. The cluster uid of the backup collection.", "readOnly": true }, "name": { "description": "Identifier. Full resource path of the backup collection.", "type": "string" }, "kmsKey": { "type": "string", "description": "Output only. The KMS key used to encrypt the backups under this backup collection.", "readOnly": true }, "lastBackupTime": { "readOnly": true, "type": "string", "description": "Output only. The last time a backup was created in the backup collection.", "format": "google-datetime" } }, "id": "BackupCollection" }, "ZoneDistributionConfig": { "description": "Zone distribution config for allocation of cluster resources.", "type": "object", "properties": { "mode": { "enumDescriptions": [ "Not Set. Default: MULTI_ZONE", "Distribute all resources across 3 zones picked at random, within the region.", "Distribute all resources in a single zone. The zone field must be specified, when this mode is selected." ], "enum": [ "ZONE_DISTRIBUTION_MODE_UNSPECIFIED", "MULTI_ZONE", "SINGLE_ZONE" ], "description": "Optional. The mode of zone distribution. Defaults to MULTI_ZONE, when not specified.", "type": "string" }, "zone": { "type": "string", "description": "Optional. When SINGLE ZONE distribution is selected, zone field would be used to allocate all resources in that zone. This is not applicable to MULTI_ZONE, and would be ignored for MULTI_ZONE clusters." } }, "id": "ZoneDistributionConfig" }, "BackupClusterRequest": { "type": "object", "properties": { "ttl": { "description": "Optional. TTL for the backup to expire. Value range is 1 day to 100 years. If not specified, the default value is 100 years.", "format": "google-duration", "type": "string" }, "backupId": { "type": "string", "description": "Optional. The id of the backup to be created. If not specified, the default value ([YYYYMMDDHHMMSS]_[Shortened Cluster UID] is used." } }, "description": "Request for `BackupCluster`.", "id": "BackupClusterRequest" }, "Membership": { "type": "object", "properties": { "primaryCluster": { "description": "Output only. The primary cluster that acts as the source of replication for the secondary clusters.", "readOnly": true, "$ref": "RemoteCluster" }, "secondaryClusters": { "type": "array", "description": "Output only. The list of secondary clusters replicating from the primary cluster.", "items": { "$ref": "RemoteCluster" }, "readOnly": true } }, "description": "An output only view of all the member clusters participating in the cross cluster replication.", "id": "Membership" }, "GcsDestination": { "description": "The Cloud Storage location for the output content", "type": "object", "properties": { "uri": { "type": "string", "description": "Required. Data destination URI (e.g. 'gs://my_bucket/my_object'). Existing files will be overwritten." } }, "id": "GcsDestination" }, "RemoteCluster": { "description": "Details of the remote cluster associated with this cluster in a cross cluster replication setup.", "type": "object", "properties": { "cluster": { "description": "Output only. The full resource path of the remote cluster in the format: projects//locations//clusters/", "type": "string", "readOnly": true }, "uid": { "readOnly": true, "description": "Output only. The unique identifier of the remote cluster.", "type": "string" } }, "id": "RemoteCluster" }, "DatabaseResourceHealthSignalData": { "type": "object", "properties": { "location": { "description": "This is used to identify the location of the resource. Example: \"us-central1\"", "type": "string" }, "signalClass": { "description": "Required. The class of the signal, such as if it's a THREAT or VULNERABILITY.", "type": "string", "enumDescriptions": [ "Unspecified signal class.", "Describes unwanted or malicious activity.", "Describes a potential weakness in software that increases risk to Confidentiality & Integrity & Availability.", "Describes a potential weakness in cloud resource/asset configuration that increases risk.", "Describes a security observation that is for informational purposes.", "Describes an error that prevents some SCC functionality." ], "enum": [ "CLASS_UNSPECIFIED", "THREAT", "VULNERABILITY", "MISCONFIGURATION", "OBSERVATION", "ERROR" ] }, "additionalMetadata": { "description": "Any other additional metadata", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "provider": { "enumDescriptions": [ "", "Google cloud platform provider", "Amazon web service", "Azure web service", "On-prem database resources.", "Self-managed database provider. These are resources on a cloud platform, e.g., database resource installed in a GCE VM, but not a managed database service.", "For the rest of the other categories. Other refers to the rest of other database service providers, this could be smaller cloud provider. This needs to be provided when the provider is known, but it is not present in the existing set of enum values." ], "enum": [ "PROVIDER_UNSPECIFIED", "GCP", "AWS", "AZURE", "ONPREM", "SELFMANAGED", "PROVIDER_OTHER" ], "type": "string", "description": "Cloud provider name. Ex: GCP/AWS/Azure/OnPrem/SelfManaged" }, "description": { "type": "string", "description": "Description associated with signal" }, "signalType": { "type": "string", "enumDeprecated": [ false, false, false, true, true, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, false ], "description": "Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.", "enum": [ "SIGNAL_TYPE_UNSPECIFIED", "SIGNAL_TYPE_NOT_PROTECTED_BY_AUTOMATIC_FAILOVER", "SIGNAL_TYPE_GROUP_NOT_REPLICATING_ACROSS_REGIONS", "SIGNAL_TYPE_NOT_AVAILABLE_IN_MULTIPLE_ZONES", "SIGNAL_TYPE_NOT_AVAILABLE_IN_MULTIPLE_REGIONS", "SIGNAL_TYPE_NO_PROMOTABLE_REPLICA", "SIGNAL_TYPE_NO_AUTOMATED_BACKUP_POLICY", "SIGNAL_TYPE_SHORT_BACKUP_RETENTION", "SIGNAL_TYPE_LAST_BACKUP_FAILED", "SIGNAL_TYPE_LAST_BACKUP_OLD", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_2_0", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_3", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_2", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_1", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_0", "SIGNAL_TYPE_VIOLATES_CIS_CONTROLS_V8_0", "SIGNAL_TYPE_VIOLATES_NIST_800_53", "SIGNAL_TYPE_VIOLATES_NIST_800_53_R5", "SIGNAL_TYPE_VIOLATES_NIST_CYBERSECURITY_FRAMEWORK_V1_0", "SIGNAL_TYPE_VIOLATES_ISO_27001", "SIGNAL_TYPE_VIOLATES_ISO_27001_V2022", "SIGNAL_TYPE_VIOLATES_PCI_DSS_V3_2_1", "SIGNAL_TYPE_VIOLATES_PCI_DSS_V4_0", "SIGNAL_TYPE_VIOLATES_CLOUD_CONTROLS_MATRIX_V4", "SIGNAL_TYPE_VIOLATES_HIPAA", "SIGNAL_TYPE_VIOLATES_SOC2_V2017", "SIGNAL_TYPE_LOGS_NOT_OPTIMIZED_FOR_TROUBLESHOOTING", "SIGNAL_TYPE_QUERY_DURATIONS_NOT_LOGGED", "SIGNAL_TYPE_VERBOSE_ERROR_LOGGING", "SIGNAL_TYPE_QUERY_LOCK_WAITS_NOT_LOGGED", "SIGNAL_TYPE_LOGGING_MOST_ERRORS", "SIGNAL_TYPE_LOGGING_ONLY_CRITICAL_ERRORS", "SIGNAL_TYPE_MINIMAL_ERROR_LOGGING", "SIGNAL_TYPE_QUERY_STATISTICS_LOGGED", "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_CLIENT_HOSTNAME", "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_PARSER_STATISTICS", "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_PLANNER_STATISTICS", "SIGNAL_TYPE_NOT_LOGGING_ONLY_DDL_STATEMENTS", "SIGNAL_TYPE_LOGGING_QUERY_STATISTICS", "SIGNAL_TYPE_NOT_LOGGING_TEMPORARY_FILES", "SIGNAL_TYPE_CONNECTION_MAX_NOT_CONFIGURED", "SIGNAL_TYPE_USER_OPTIONS_CONFIGURED", "SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", "SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS", "SIGNAL_TYPE_NO_ROOT_PASSWORD", "SIGNAL_TYPE_WEAK_ROOT_PASSWORD", "SIGNAL_TYPE_ENCRYPTION_KEY_NOT_CUSTOMER_MANAGED", "SIGNAL_TYPE_SERVER_AUTHENTICATION_NOT_REQUIRED", "SIGNAL_TYPE_EXPOSED_BY_OWNERSHIP_CHAINING", "SIGNAL_TYPE_EXPOSED_TO_EXTERNAL_SCRIPTS", "SIGNAL_TYPE_EXPOSED_TO_LOCAL_DATA_LOADS", "SIGNAL_TYPE_CONNECTION_ATTEMPTS_NOT_LOGGED", "SIGNAL_TYPE_DISCONNECTIONS_NOT_LOGGED", "SIGNAL_TYPE_LOGGING_EXCESSIVE_STATEMENT_INFO", "SIGNAL_TYPE_EXPOSED_TO_REMOTE_ACCESS", "SIGNAL_TYPE_DATABASE_NAMES_EXPOSED", "SIGNAL_TYPE_SENSITIVE_TRACE_INFO_NOT_MASKED", "SIGNAL_TYPE_PUBLIC_IP_ENABLED", "SIGNAL_TYPE_IDLE", "SIGNAL_TYPE_OVERPROVISIONED", "SIGNAL_TYPE_HIGH_NUMBER_OF_OPEN_TABLES", "SIGNAL_TYPE_HIGH_NUMBER_OF_TABLES", "SIGNAL_TYPE_HIGH_TRANSACTION_ID_UTILIZATION", "SIGNAL_TYPE_UNDERPROVISIONED", "SIGNAL_TYPE_OUT_OF_DISK", "SIGNAL_TYPE_SERVER_CERTIFICATE_NEAR_EXPIRY", "SIGNAL_TYPE_DATABASE_AUDITING_DISABLED", "SIGNAL_TYPE_RESTRICT_AUTHORIZED_NETWORKS", "SIGNAL_TYPE_VIOLATE_POLICY_RESTRICT_PUBLIC_IP", "SIGNAL_TYPE_QUOTA_LIMIT", "SIGNAL_TYPE_NO_PASSWORD_POLICY", "SIGNAL_TYPE_CONNECTIONS_PERFORMANCE_IMPACT", "SIGNAL_TYPE_TMP_TABLES_PERFORMANCE_IMPACT", "SIGNAL_TYPE_TRANS_LOGS_PERFORMANCE_IMPACT", "SIGNAL_TYPE_HIGH_JOINS_WITHOUT_INDEXES", "SIGNAL_TYPE_SUPERUSER_WRITING_TO_USER_TABLES", "SIGNAL_TYPE_USER_GRANTED_ALL_PERMISSIONS", "SIGNAL_TYPE_DATA_EXPORT_TO_EXTERNAL_CLOUD_STORAGE_BUCKET", "SIGNAL_TYPE_DATA_EXPORT_TO_PUBLIC_CLOUD_STORAGE_BUCKET", "SIGNAL_TYPE_WEAK_PASSWORD_HASH_ALGORITHM", "SIGNAL_TYPE_NO_USER_PASSWORD_POLICY", "SIGNAL_TYPE_HOT_NODE", "SIGNAL_TYPE_NO_POINT_IN_TIME_RECOVERY", "SIGNAL_TYPE_RESOURCE_SUSPENDED", "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", "SIGNAL_TYPE_INEFFICIENT_QUERY", "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", "SIGNAL_TYPE_MEMORY_LIMIT", "SIGNAL_TYPE_MAX_SERVER_MEMORY", "SIGNAL_TYPE_LARGE_ROWS", "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", "SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", "SIGNAL_TYPE_OUTDATED_MINOR_VERSION", "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", "SIGNAL_TYPE_OUTDATED_VERSION", "SIGNAL_TYPE_OUTDATED_CLIENT", "SIGNAL_TYPE_DATABOOST_DISABLED", "SIGNAL_TYPE_RECOMMENDED_MAINTENANCE_POLICIES", "SIGNAL_TYPE_EXTENDED_SUPPORT", "SIGNAL_TYPE_PERFORMANCE_KPI_CHANGE", "SIGNAL_TYPE_VERSION_NEARING_END_OF_LIFE" ], "enumDescriptions": [ "Unspecified.", "Represents if a resource is protected by automatic failover. Checks for resources that are configured to have redundancy within a region that enables automatic failover.", "Represents if a group is replicating across regions. Checks for resources that are configured to have redundancy, and ongoing replication, across regions.", "Represents if the resource is available in multiple zones or not.", "Represents if a resource is available in multiple regions.", "Represents if a resource has a promotable replica.", "Represents if a resource has an automated backup policy.", "Represents if a resources has a short backup retention period.", "Represents if the last backup of a resource failed.", "Represents if the last backup of a resource is older than some threshold value.", "Represents if a resource violates CIS GCP Foundation 2.0.", "Represents if a resource violates CIS GCP Foundation 1.3.", "Represents if a resource violates CIS GCP Foundation 1.2.", "Represents if a resource violates CIS GCP Foundation 1.1.", "Represents if a resource violates CIS GCP Foundation 1.0.", "Represents if a resource violates CIS Controls 8.0.", "Represents if a resource violates NIST 800-53.", "Represents if a resource violates NIST 800-53 R5.", "Represents if a resource violates NIST Cybersecurity Framework 1.0.", "Represents if a resource violates ISO-27001.", "Represents if a resource violates ISO 27001 2022.", "Represents if a resource violates PCI-DSS v3.2.1.", "Represents if a resource violates PCI-DSS v4.0.", "Represents if a resource violates Cloud Controls Matrix v4.0.", "Represents if a resource violates HIPAA.", "Represents if a resource violates SOC2 v2017.", "Represents if log_checkpoints database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_duration database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_error_verbosity database flag for a Cloud SQL for PostgreSQL instance is not set to default or stricter (default or terse).", "Represents if the log_lock_waits database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_min_error_statement database flag for a Cloud SQL for PostgreSQL instance is not set appropriately.", "Represents if the log_min_error_statement database flag for a Cloud SQL for PostgreSQL instance does not have an appropriate severity level.", "Represents if the log_min_messages database flag for a Cloud SQL for PostgreSQL instance is not set to warning or another recommended value.", "Represents if the databaseFlags property of instance metadata for the log_executor_status field is set to on.", "Represents if the log_hostname database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_parser_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_planner_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_statement database flag for a Cloud SQL for PostgreSQL instance is not set to DDL (all data definition statements).", "Represents if the log_statement_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_temp_files database flag for a Cloud SQL for PostgreSQL instance is not set to \"0\". (NOTE: 0 = ON)", "Represents if the user connections database flag for a Cloud SQL for SQL Server instance is configured.", "Represents if the user options database flag for Cloud SQL SQL Server instance is configured or not.", "Represents if a resource is exposed to public access.", "Represents if a resources requires all incoming connections to use SSL or not.", "Represents if a Cloud SQL database has a password configured for the root account or not.", "Represents if a Cloud SQL database has a weak password configured for the root account.", "Represents if a SQL database instance is not encrypted with customer-managed encryption keys (CMEK).", "Represents if The contained database authentication database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if the cross_db_ownership_chaining database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if he external scripts enabled database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if the local_infile database flag for a Cloud SQL for MySQL instance is not set to off.", "Represents if the log_connections database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_disconnections database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_min_duration_statement database flag for a Cloud SQL for PostgreSQL instance is not set to -1.", "Represents if the remote access database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if the skip_show_database database flag for a Cloud SQL for MySQL instance is not set to on.", "Represents if the 3625 (trace flag) database flag for a Cloud SQL for SQL Server instance is not set to on.", "Represents if public IP is enabled.", "Represents Idle instance helps to reduce costs.", "Represents instances that are unnecessarily large for given workload.", "Represents high number of concurrently opened tables.", "Represents high table count close to SLA limit.", "Represents high number of unvacuumed transactions", "Represents need for more CPU and/or memory", "Represents out of disk.", "Represents server certificate is near expiry.", "Represents database auditing is disabled.", "Represents not restricted to authorized networks.", "Represents violate org policy restrict public ip.", "Cluster nearing quota limit", "No password policy set on resources", "Performance impact of connections settings", "Performance impact of temporary tables settings", "Performance impact of transaction logs settings", "Performance impact of high joins without indexes", "Detects events where a Cloud SQL superuser (postgres for PostgreSQL servers or root for MySQL users) writes to non-system tables.", "Detects events where a database user or role has been granted all privileges to a database, or to all tables, procedures, or functions in a schema.", "Detects if database instance data exported to a Cloud Storage bucket outside of the organization.", "Detects if database instance data exported to a Cloud Storage bucket that is owned by the organization and is publicly accessible.", "Detects if a database instance is using a weak password hash algorithm.", "Detects if a database instance has no user password policy set.", "Detects if a database instance/cluster has a hot node.", "Detects if a database instance has no point in time recovery enabled.", "Detects if a database instance/cluster is suspended.", "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", "Indicates that the instance has inefficient queries detected.", "Indicates that the instance has read intensive workload.", "Indicates that the instance is nearing memory limit.", "Indicates that the instance's max server memory is configured higher than the recommended value.", "Indicates that the database has large rows beyond the recommended limit.", "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", "Location org policy not satisfied.", "Outdated DB minor version.", "Schema not optimized.", "High number of idle connections.", "Replication delay.", "Outdated version.", "Outdated client.", "Databoost is disabled.", "Recommended maintenance policy.", "Resource version is in extended support.", "Change in performance KPIs.", "Database version nearing end of life." ] }, "eventTime": { "description": "Required. The last time at which the event described by this signal took place", "format": "google-datetime", "type": "string" }, "compliance": { "type": "array", "description": "Industry standards associated with this signal; if this signal is an issue, that could be a violation of the associated industry standard(s). For example, AUTO_BACKUP_DISABLED signal is associated with CIS GCP 1.1, CIS GCP 1.2, CIS GCP 1.3, NIST 800-53 and ISO-27001 compliance standards. If a database resource does not have automated backup enable, it will violate these following industry standards.", "items": { "$ref": "Compliance" } }, "signalId": { "description": "Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", "type": "string" }, "resourceContainer": { "description": "Closest parent container of this resource. In GCP, 'container' refers to a Cloud Resource Manager project. It must be resource name of a Cloud Resource Manager project with the format of \"provider//\", such as \"projects/123\". For GCP provided resources, number should be project number.", "type": "string" }, "state": { "enumDescriptions": [ "Unspecified state.", "The signal requires attention and has not been addressed yet.", "The signal has been fixed, triaged as a non-issue or otherwise addressed and is no longer active.", "The signal has been muted." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "RESOLVED", "MUTED" ], "type": "string" }, "signalSeverity": { "type": "string", "description": "The severity of the signal, such as if it's a HIGH or LOW severity.", "enumDescriptions": [ "This value is used for findings when a source doesn't write a severity value.", "A critical vulnerability is easily discoverable by an external actor, exploitable.", "A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities.", "A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually gain access and the ability to execute arbitrary code or exfiltrate data.", "A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment." ], "enum": [ "SIGNAL_SEVERITY_UNSPECIFIED", "CRITICAL", "HIGH", "MEDIUM", "LOW" ] }, "externalUri": { "description": "The external-uri of the signal, using which more information about this signal can be obtained. In GCP, this will take user to SCC page to get more details about signals.", "type": "string" }, "name": { "description": "Required. The name of the signal, ex: PUBLIC_SQL_INSTANCE, SQL_LOG_ERROR_VERBOSITY etc.", "type": "string" }, "resourceName": { "type": "string", "description": "Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel" } }, "description": "Common model for database resource health signal data.", "id": "DatabaseResourceHealthSignalData" }, "OutputConfig": { "id": "OutputConfig", "type": "object", "properties": { "gcsDestination": { "description": "Google Cloud Storage destination for output content.", "$ref": "GcsDestination" } }, "description": "The output content" }, "PscConnection": { "id": "PscConnection", "type": "object", "properties": { "pscConnectionStatus": { "enum": [ "PSC_CONNECTION_STATUS_UNSPECIFIED", "PSC_CONNECTION_STATUS_ACTIVE", "PSC_CONNECTION_STATUS_NOT_FOUND" ], "readOnly": true, "description": "Output only. The status of the PSC connection. Please note that this value is updated periodically. To get the latest status of a PSC connection, follow https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details.", "type": "string", "enumDescriptions": [ "PSC connection status is not specified.", "The connection is active", "Connection not found" ] }, "projectId": { "type": "string", "description": "Optional. Project ID of the consumer project where the forwarding rule is created in." }, "pscConnectionId": { "description": "Required. The PSC connection id of the forwarding rule connected to the service attachment.", "type": "string" }, "forwardingRule": { "type": "string", "description": "Required. The URI of the consumer side forwarding rule. Example: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}." }, "serviceAttachment": { "type": "string", "description": "Required. The service attachment which is the target of the PSC connection, in the form of projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}." }, "connectionType": { "enum": [ "CONNECTION_TYPE_UNSPECIFIED", "CONNECTION_TYPE_DISCOVERY", "CONNECTION_TYPE_PRIMARY", "CONNECTION_TYPE_READER" ], "readOnly": true, "description": "Output only. Type of the PSC connection.", "type": "string", "enumDescriptions": [ "Cluster endpoint Type is not set", "Cluster endpoint that will be used as for cluster topology discovery.", "Cluster endpoint that will be used as primary endpoint to access primary.", "Cluster endpoint that will be used as reader endpoint to access replicas." ] }, "address": { "description": "Required. The IP allocated on the consumer network for the PSC forwarding rule.", "type": "string" }, "network": { "type": "string", "description": "Required. The consumer network where the IP address resides, in the form of projects/{project_id}/global/networks/{network_id}." }, "port": { "readOnly": true, "description": "Output only. port will only be set for Primary/Reader or Discovery endpoint.", "format": "int32", "type": "integer" } }, "description": "Details of consumer resources in a PSC connection." }, "Location": { "type": "object", "properties": { "name": { "type": "string", "description": "Full resource name for the region. For example: \"projects/example-project/locations/us-east1\"." }, "locationId": { "type": "string", "description": "Resource ID for the region. For example: \"us-east1\"." }, "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "labels": { "type": "object", "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "additionalProperties": { "type": "string" } }, "metadata": { "type": "object", "description": "Output only. The set of available zones in the location. The map is keyed by the lowercase ID of each zone, as defined by Compute Engine. These keys can be specified in `location_id` or `alternative_location_id` fields when creating a Redis instance.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } } }, "description": "A resource that represents a Google Cloud location.", "id": "Location" }, "AutomatedBackupConfig": { "id": "AutomatedBackupConfig", "type": "object", "properties": { "fixedFrequencySchedule": { "$ref": "FixedFrequencySchedule", "description": "Optional. Trigger automated backups at a fixed frequency." }, "retention": { "type": "string", "description": "Optional. How long to keep automated backups before the backups are deleted. The value should be between 1 day and 365 days. If not specified, the default value is 35 days.", "format": "google-duration" }, "automatedBackupMode": { "enumDescriptions": [ "Default value. Automated backup config is not specified.", "Automated backup config disabled.", "Automated backup config enabled." ], "enum": [ "AUTOMATED_BACKUP_MODE_UNSPECIFIED", "DISABLED", "ENABLED" ], "type": "string", "description": "Optional. The automated backup mode. If the mode is disabled, the other fields will be ignored." } }, "description": "The automated backup config for a cluster." }, "ListClustersResponse": { "description": "Response for `ListClusters`.", "type": "object", "properties": { "unreachable": { "type": "array", "description": "Locations that could not be reached.", "items": { "type": "string" } }, "clusters": { "type": "array", "description": "A list of Redis clusters in the project in the specified location, or across all locations. If the `location_id` in the parent field of the request is \"-\", all regions available to the project are queried, and the results aggregated. If in such an aggregated query a location is unavailable, a placeholder Redis entry is included in the response with the `name` field set to a value of the form `projects/{project_id}/locations/{location_id}/clusters/`- and the `status` field set to ERROR and `status_message` field set to \"location not available for ListClusters\".", "items": { "$ref": "Cluster" } }, "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, "id": "ListClustersResponse" }, "TokenAuthUser": { "description": "Represents a token based auth user for the cluster.", "type": "object", "properties": { "name": { "description": "Identifier. The resource name of the token based auth user. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}", "type": "string" }, "state": { "description": "Output only. The state of the token based auth user.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "UPDATING", "DELETING" ], "readOnly": true, "enumDescriptions": [ "Not set.", "The auth user is active.", "The auth user is being created.", "The auth user is being updated.", "The auth user is being deleted." ] } }, "id": "TokenAuthUser" }, "CustomMetadataData": { "id": "CustomMetadataData", "type": "object", "properties": { "internalResourceMetadata": { "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration.", "items": { "$ref": "InternalResourceMetadata" }, "type": "array" } }, "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data" }, "FixedFrequencySchedule": { "description": "This schedule allows the backup to be triggered at a fixed frequency (currently only daily is supported).", "type": "object", "properties": { "startTime": { "description": "Required. The start time of every automated backup in UTC. It must be set to the start of an hour. This field is required.", "$ref": "TimeOfDay" } }, "id": "FixedFrequencySchedule" }, "BackupRun": { "id": "BackupRun", "description": "A backup run.", "type": "object", "properties": { "endTime": { "type": "string", "description": "The time the backup operation completed. REQUIRED", "format": "google-datetime" }, "startTime": { "description": "The time the backup operation started. REQUIRED", "format": "google-datetime", "type": "string" }, "status": { "enumDescriptions": [ "", "The backup was successful.", "The backup was unsuccessful." ], "enum": [ "STATUS_UNSPECIFIED", "SUCCESSFUL", "FAILED" ], "type": "string", "description": "The status of this run. REQUIRED" }, "error": { "description": "Information about why the backup operation failed. This is only present if the run has the FAILED status. OPTIONAL", "$ref": "OperationError" } } }, "PscServiceAttachment": { "id": "PscServiceAttachment", "type": "object", "properties": { "serviceAttachment": { "description": "Output only. Service attachment URI which your self-created PscConnection should use as target", "type": "string", "readOnly": true }, "connectionType": { "type": "string", "description": "Output only. Type of a PSC connection targeting this service attachment.", "readOnly": true, "enum": [ "CONNECTION_TYPE_UNSPECIFIED", "CONNECTION_TYPE_DISCOVERY", "CONNECTION_TYPE_PRIMARY", "CONNECTION_TYPE_READER" ], "enumDescriptions": [ "Cluster endpoint Type is not set", "Cluster endpoint that will be used as for cluster topology discovery.", "Cluster endpoint that will be used as primary endpoint to access primary.", "Cluster endpoint that will be used as reader endpoint to access replicas." ] } }, "description": "Configuration of a service attachment of the cluster, for creating PSC connections." }, "PscConfig": { "id": "PscConfig", "type": "object", "properties": { "network": { "type": "string", "description": "Required. The network where the IP address of the discovery endpoint will be reserved, in the form of projects/{network_project}/global/networks/{network_id}." } } }, "NodeInfo": { "id": "NodeInfo", "description": "Node specific properties.", "type": "object", "properties": { "id": { "readOnly": true, "description": "Output only. Node identifying string. e.g. 'node-0', 'node-1'", "type": "string" }, "zone": { "readOnly": true, "type": "string", "description": "Output only. Location of the node." } } }, "Cluster": { "id": "Cluster", "description": "A cluster instance.", "type": "object", "properties": { "encryptionInfo": { "readOnly": true, "$ref": "EncryptionInfo", "description": "Output only. Encryption information of the data at rest of the cluster." }, "labels": { "type": "object", "description": "Optional. Labels to represent user-provided metadata.", "additionalProperties": { "type": "string" } }, "uid": { "type": "string", "description": "Output only. System assigned, unique identifier for the cluster.", "readOnly": true }, "effectiveMaintenanceVersion": { "readOnly": true, "type": "string", "description": "Output only. This field represents the actual maintenance version of the cluster." }, "discoveryEndpoints": { "description": "Output only. Endpoints created on each given network, for Redis clients to connect to the cluster. Currently only one discovery endpoint is supported.", "items": { "$ref": "DiscoveryEndpoint" }, "type": "array", "readOnly": true }, "crossClusterReplicationConfig": { "$ref": "CrossClusterReplicationConfig", "description": "Optional. Cross cluster replication config." }, "replicaCount": { "description": "Optional. The number of replica nodes per shard.", "format": "int32", "type": "integer" }, "maintenanceVersion": { "type": "string", "description": "Optional. This field can be used to trigger self service update to indicate the desired maintenance version. The input to this field can be determined by the available_maintenance_versions field." }, "state": { "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "UPDATING", "DELETING" ], "type": "string", "description": "Output only. The current state of this cluster. Can be CREATING, READY, UPDATING, DELETING and SUSPENDED", "enumDescriptions": [ "Not set.", "Redis cluster is being created.", "Redis cluster has been created and is fully usable.", "Redis cluster configuration is being updated.", "Redis cluster is being deleted." ] }, "aclPolicy": { "type": "string", "description": "Optional. The ACL policy to be applied to the cluster." }, "redisConfigs": { "type": "object", "description": "Optional. Key/Value pairs of customer overrides for mutable Redis Configs", "additionalProperties": { "type": "string" } }, "automatedBackupConfig": { "$ref": "AutomatedBackupConfig", "description": "Optional. The automated backup config for the cluster." }, "serverCaPool": { "description": "Optional. Customer-managed CA pool for the cluster. Only applicable for BYOCA i.e. if server_ca_mode is SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA. Format: \"projects/{project}/locations/{region}/caPools/{ca_pool}\".", "type": "string" }, "managedBackupSource": { "$ref": "ManagedBackupSource", "description": "Optional. Backups generated and managed by memorystore service." }, "shardCount": { "description": "Optional. Number of shards for the Redis cluster.", "format": "int32", "type": "integer" }, "maintenanceSchedule": { "readOnly": true, "$ref": "ClusterMaintenanceSchedule", "description": "Output only. ClusterMaintenanceSchedule Output only Published maintenance schedule." }, "authorizationMode": { "enumDescriptions": [ "Not set.", "IAM basic authorization mode", "Authorization disabled mode", "Token based authorization mode" ], "enum": [ "AUTH_MODE_UNSPECIFIED", "AUTH_MODE_IAM_AUTH", "AUTH_MODE_DISABLED", "AUTH_MODE_TOKEN_AUTH" ], "type": "string", "description": "Optional. The authorization mode of the Redis cluster. If not provided, auth feature is disabled for the cluster." }, "pscServiceAttachments": { "readOnly": true, "description": "Output only. Service attachment details to configure Psc connections", "items": { "$ref": "PscServiceAttachment" }, "type": "array" }, "pscConnections": { "readOnly": true, "description": "Output only. The list of PSC connections that are auto-created through service connectivity automation.", "items": { "$ref": "PscConnection" }, "type": "array" }, "preciseSizeGb": { "type": "number", "description": "Output only. Precise value of redis memory size in GB for the entire cluster.", "format": "double", "readOnly": true }, "satisfiesPzi": { "readOnly": true, "type": "boolean", "description": "Optional. Output only. Reserved for future use." }, "clusterEndpoints": { "type": "array", "description": "Optional. A list of cluster endpoints.", "items": { "$ref": "ClusterEndpoint" } }, "maintenancePolicy": { "$ref": "ClusterMaintenancePolicy", "description": "Optional. ClusterMaintenancePolicy determines when to allow or deny updates." }, "kmsKey": { "description": "Optional. The KMS key used to encrypt the at-rest data of the cluster.", "type": "string" }, "serverCaMode": { "type": "string", "description": "Optional. Server CA mode for the cluster.", "enumDescriptions": [ "Server CA mode not specified.", "Each cluster has its own Google managed CA.", "The cluster uses Google managed shared CA in the region.", "The cluster uses customer managed CA from CAS." ], "enum": [ "SERVER_CA_MODE_UNSPECIFIED", "SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA", "SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA", "SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA" ] }, "stateInfo": { "readOnly": true, "$ref": "StateInfo", "description": "Output only. Additional information about the current state of the cluster." }, "nodeType": { "enumDescriptions": [ "Node type unspecified", "Redis shared core nano node_type.", "Redis highmem medium node_type.", "Redis highmem xlarge node_type.", "Redis standard small node_type.", "Redis highcpu medium node_type.", "Redis standard large node_type.", "Redis highmem 2xlarge node_type." ], "enum": [ "NODE_TYPE_UNSPECIFIED", "REDIS_SHARED_CORE_NANO", "REDIS_HIGHMEM_MEDIUM", "REDIS_HIGHMEM_XLARGE", "REDIS_STANDARD_SMALL", "REDIS_HIGHCPU_MEDIUM", "REDIS_STANDARD_LARGE", "REDIS_HIGHMEM_2XLARGE" ], "type": "string", "description": "Optional. The type of a redis node in the cluster. NodeType determines the underlying machine-type of a redis node." }, "aclPolicyInSync": { "readOnly": true, "type": "boolean", "description": "Optional. Output only. Indicates whether the ACL rules applied to the cluster are in sync with the latest ACL policy rules. This field is only applicable if the ACL policy is set for the cluster." }, "createTime": { "description": "Output only. The timestamp associated with the cluster creation request.", "format": "google-datetime", "type": "string", "readOnly": true }, "allowFewerZonesDeployment": { "description": "Optional. Immutable. Deprecated, do not use.", "deprecated": true, "type": "boolean" }, "sizeGb": { "readOnly": true, "type": "integer", "description": "Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.", "format": "int32" }, "deletionProtectionEnabled": { "description": "Optional. The delete operation will fail when the value is set to true.", "type": "boolean" }, "ondemandMaintenance": { "type": "boolean", "description": "Optional. Input only. Ondemand maintenance for the cluster. This field can be used to trigger ondemand critical update on the cluster.", "deprecated": true }, "gcsSource": { "$ref": "GcsBackupSource", "description": "Optional. Backups stored in Cloud Storage buckets. The Cloud Storage buckets need to be the same region as the clusters. Read permission is required to import from the provided Cloud Storage objects." }, "name": { "description": "Required. Identifier. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}`", "type": "string" }, "transitEncryptionMode": { "enumDescriptions": [ "In-transit encryption not set.", "In-transit encryption disabled.", "Use server managed encryption for in-transit encryption." ], "enum": [ "TRANSIT_ENCRYPTION_MODE_UNSPECIFIED", "TRANSIT_ENCRYPTION_MODE_DISABLED", "TRANSIT_ENCRYPTION_MODE_SERVER_AUTHENTICATION" ], "type": "string", "description": "Optional. The in-transit encryption for the Redis cluster. If not provided, encryption is disabled for the cluster." }, "persistenceConfig": { "description": "Optional. Persistence config (RDB, AOF) for the cluster.", "$ref": "ClusterPersistenceConfig" }, "zoneDistributionConfig": { "$ref": "ZoneDistributionConfig", "description": "Optional. This config will be used to determine how the customer wants us to distribute cluster resources within the region." }, "satisfiesPzs": { "type": "boolean", "description": "Optional. Output only. Reserved for future use.", "readOnly": true }, "simulateMaintenanceEvent": { "type": "boolean", "description": "Optional. Input only. Simulate a maintenance event." }, "asyncClusterEndpointsDeletionEnabled": { "description": "Optional. If true, cluster endpoints that are created and registered by customers can be deleted asynchronously. That is, such a cluster endpoint can be de-registered before the forwarding rules in the cluster endpoint are deleted.", "type": "boolean" }, "backupCollection": { "description": "Optional. Output only. The backup collection full resource name. Example: projects/{project}/locations/{location}/backupCollections/{collection}", "type": "string", "readOnly": true }, "rotateServerCertificate": { "description": "Optional. Input only. Rotate the server certificates.", "type": "boolean" }, "pscConfigs": { "type": "array", "description": "Optional. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported.", "items": { "$ref": "PscConfig" } }, "availableMaintenanceVersions": { "readOnly": true, "type": "array", "description": "Output only. This field is used to determine the available maintenance versions for the self service update.", "items": { "type": "string" } } } }, "RegionalCertChain": { "type": "object", "properties": { "certificates": { "type": "array", "description": "The certificates that form the CA chain, from leaf to root order.", "items": { "type": "string" } } }, "description": "The certificates that form the CA chain, from leaf to root order.", "id": "RegionalCertChain" }, "InternalResourceMetadata": { "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.", "type": "object", "properties": { "backupConfiguration": { "description": "Backup configuration for this database", "$ref": "BackupConfiguration" }, "backupRun": { "$ref": "BackupRun", "description": "Information about the last backup attempt for this database" }, "resourceId": { "$ref": "DatabaseResourceId" }, "resourceName": { "description": "Required. internal resource name for spanner this will be database name e.g.\"spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1\"", "type": "string" }, "product": { "$ref": "Product" }, "isDeletionProtectionEnabled": { "description": "Whether deletion protection is enabled for this internal resource.", "type": "boolean" } }, "id": "InternalResourceMetadata" }, "Compliance": { "description": "Contains compliance information about a security standard indicating unmet recommendations.", "type": "object", "properties": { "standard": { "description": "Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.", "type": "string" }, "version": { "description": "Version of the standard or benchmark, for example, 1.1", "type": "string" } }, "id": "Compliance" }, "AclPolicy": { "type": "object", "properties": { "version": { "description": "Output only. The version of the ACL policy. Used in drift resolution.", "format": "int64", "type": "string", "readOnly": true }, "state": { "enumDescriptions": [ "Not set.", "ACL Policy has been created and is fully usable. Since ACL Policy creation is synchronous and not an LRO, there is no CREATING state.", "ACL Policy is being updated.", "ACL Policy is being deleted." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "UPDATING", "DELETING" ], "readOnly": true, "description": "Output only. The state of the ACL policy.", "type": "string" }, "etag": { "readOnly": true, "type": "string", "description": "Output only. Etag for the ACL policy." }, "rules": { "description": "Required. The ACL rules within the ACL policy.", "items": { "$ref": "AclRule" }, "type": "array" }, "name": { "description": "Identifier. Full resource path of the ACL policy.", "type": "string" } }, "description": "The ACL policy resource.", "id": "AclPolicy" }, "ImportInstanceRequest": { "type": "object", "properties": { "inputConfig": { "description": "Required. Specify data to be imported.", "$ref": "InputConfig" } }, "description": "Request for Import.", "id": "ImportInstanceRequest" }, "DatabaseResourceId": { "description": "DatabaseResourceId will serve as primary key for any resource ingestion event.", "type": "object", "properties": { "provider": { "enumDescriptions": [ "", "Google cloud platform provider", "Amazon web service", "Azure web service", "On-prem database resources.", "Self-managed database provider. These are resources on a cloud platform, e.g., database resource installed in a GCE VM, but not a managed database service.", "For the rest of the other categories. Other refers to the rest of other database service providers, this could be smaller cloud provider. This needs to be provided when the provider is known, but it is not present in the existing set of enum values." ], "enum": [ "PROVIDER_UNSPECIFIED", "GCP", "AWS", "AZURE", "ONPREM", "SELFMANAGED", "PROVIDER_OTHER" ], "description": "Required. Cloud provider name. Ex: GCP/AWS/Azure/OnPrem/SelfManaged", "type": "string" }, "providerDescription": { "description": "Optional. Needs to be used only when the provider is PROVIDER_OTHER.", "type": "string" }, "uniqueId": { "type": "string", "description": "Required. A service-local token that distinguishes this resource from other resources within the same service." }, "resourceType": { "description": "Required. The type of resource this ID is identifying. Ex go/keep-sorted start alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance compute.googleapis.com/Instance firestore.googleapis.com/Database, redis.googleapis.com/Instance, redis.googleapis.com/Cluster, oracledatabase.googleapis.com/CloudExadataInfrastructure oracledatabase.googleapis.com/CloudVmCluster oracledatabase.googleapis.com/AutonomousDatabase spanner.googleapis.com/Instance, spanner.googleapis.com/Database, sqladmin.googleapis.com/Instance, go/keep-sorted end REQUIRED Please refer go/condor-common-datamodel", "type": "string" } }, "id": "DatabaseResourceId" }, "ListOperationsResponse": { "type": "object", "properties": { "operations": { "type": "array", "description": "A list of operations that matches the specified filter in the request.", "items": { "$ref": "Operation" } }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." }, "unreachable": { "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", "items": { "type": "string" }, "type": "array" } }, "description": "The response message for Operations.ListOperations.", "id": "ListOperationsResponse" }, "ResourceMaintenanceDenySchedule": { "type": "object", "properties": { "startDate": { "$ref": "Date", "description": "Optional. The start date of the deny maintenance period." }, "endDate": { "$ref": "Date", "description": "Optional. Deny period end date." }, "time": { "$ref": "TimeOfDay", "description": "Optional. Time in UTC when the deny period starts on start_date and ends on end_date." } }, "description": "Deny maintenance period for the database resource. It specifies the time range during which the maintenance cannot start. This is configured by the customer.", "id": "ResourceMaintenanceDenySchedule" }, "GoogleCloudRedisV1beta1LocationMetadata": { "type": "object", "properties": { "availableZones": { "type": "object", "description": "Output only. The set of available zones in the location. The map is keyed by the lowercase ID of each zone, as defined by GCE. These keys can be specified in `location_id` or `alternative_location_id` fields when creating a Redis instance.", "additionalProperties": { "$ref": "GoogleCloudRedisV1beta1ZoneMetadata" }, "readOnly": true } }, "description": "This location metadata represents additional configuration options for a given location where a Redis instance may be created. All fields are output only. It is returned as content of the `google.cloud.location.Location.metadata` field.", "id": "GoogleCloudRedisV1beta1LocationMetadata" }, "GoogleCloudRedisV1beta1ZoneMetadata": { "id": "GoogleCloudRedisV1beta1ZoneMetadata", "type": "object", "properties": {}, "description": "Defines specific information for a particular zone. Currently empty and reserved for future use only." }, "CertificateAuthority": { "description": "Redis cluster certificate authority", "type": "object", "properties": { "managedServerCa": { "$ref": "ManagedCertificateAuthority" }, "name": { "type": "string", "description": "Identifier. Unique name of the resource in this scope including project, location and cluster using the form: `projects/{project}/locations/{location}/clusters/{cluster}/certificateAuthority`" } }, "id": "CertificateAuthority" }, "ClusterMaintenanceSchedule": { "type": "object", "properties": { "startTime": { "type": "string", "description": "Output only. The start time of any upcoming scheduled maintenance for this instance.", "format": "google-datetime", "readOnly": true }, "endTime": { "description": "Output only. The end time of any upcoming scheduled maintenance for this instance.", "format": "google-datetime", "type": "string", "readOnly": true } }, "description": "Upcoming maintenance schedule.", "id": "ClusterMaintenanceSchedule" }, "DatabaseResourceFeed": { "type": "object", "properties": { "databaseResourceSignalData": { "description": "Database resource signal data is used to ingest signals from database resource signal feeds.", "$ref": "DatabaseResourceSignalData" }, "resourceId": { "description": "Primary key associated with the Resource. resource_id is available in individual feed level as well.", "deprecated": true, "$ref": "DatabaseResourceId" }, "observabilityMetricData": { "$ref": "ObservabilityMetricData" }, "feedType": { "type": "string", "description": "Required. Type feed to be ingested into condor", "enumDescriptions": [ "", "Database resource metadata feed from control plane", "Database resource monitoring data", "Database resource security health signal data", "Database resource recommendation signal data", "Database config based signal data", "Database resource metadata from BackupDR", "Database resource signal data" ], "enum": [ "FEEDTYPE_UNSPECIFIED", "RESOURCE_METADATA", "OBSERVABILITY_DATA", "SECURITY_FINDING_DATA", "RECOMMENDATION_SIGNAL_DATA", "CONFIG_BASED_SIGNAL_DATA", "BACKUPDR_METADATA", "DATABASE_RESOURCE_SIGNAL_DATA" ] }, "configBasedSignalData": { "description": "Config based signal data is used to ingest signals that are generated based on the configuration of the database resource.", "$ref": "ConfigBasedSignalData" }, "skipIngestion": { "description": "Optional. If true, the feed won't be ingested by DB Center. This indicates that the feed is intentionally skipped. For example, BackupDR feeds are only needed for resources integrated with DB Center (e.g., CloudSQL, AlloyDB). Feeds for non-integrated resources (e.g., Compute Engine, Persistent Disk) can be skipped.", "type": "boolean" }, "feedTimestamp": { "type": "string", "description": "Required. Timestamp when feed is generated.", "format": "google-datetime" }, "resourceHealthSignalData": { "$ref": "DatabaseResourceHealthSignalData" }, "recommendationSignalData": { "$ref": "DatabaseResourceRecommendationSignalData" }, "resourceMetadata": { "$ref": "DatabaseResourceMetadata" }, "backupdrMetadata": { "description": "BackupDR metadata is used to ingest metadata from BackupDR.", "$ref": "BackupDRMetadata" } }, "description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 13", "id": "DatabaseResourceFeed" }, "ManagedCertificateAuthority": { "id": "ManagedCertificateAuthority", "type": "object", "properties": { "caCerts": { "type": "array", "description": "The PEM encoded CA certificate chains for redis managed server authentication", "items": { "$ref": "CertChain" } } } }, "ClusterWeeklyMaintenanceWindow": { "id": "ClusterWeeklyMaintenanceWindow", "description": "Time window specified for weekly operations.", "type": "object", "properties": { "day": { "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "description": "Optional. Allows to define schedule that runs specified day of the week.", "type": "string" }, "startTime": { "$ref": "TimeOfDay", "description": "Optional. Start time of the window in UTC." } } }, "UpdateInfo": { "type": "object", "properties": { "targetNodeType": { "description": "Target node type for redis cluster.", "type": "string", "enumDescriptions": [ "Node type unspecified", "Redis shared core nano node_type.", "Redis highmem medium node_type.", "Redis highmem xlarge node_type.", "Redis standard small node_type.", "Redis highcpu medium node_type.", "Redis standard large node_type.", "Redis highmem 2xlarge node_type." ], "enum": [ "NODE_TYPE_UNSPECIFIED", "REDIS_SHARED_CORE_NANO", "REDIS_HIGHMEM_MEDIUM", "REDIS_HIGHMEM_XLARGE", "REDIS_STANDARD_SMALL", "REDIS_HIGHCPU_MEDIUM", "REDIS_STANDARD_LARGE", "REDIS_HIGHMEM_2XLARGE" ] }, "targetShardCount": { "type": "integer", "description": "Target number of shards for redis cluster", "format": "int32" }, "targetReplicaCount": { "description": "Target number of replica nodes per shard.", "format": "int32", "type": "integer" } }, "description": "Represents information about an updating cluster.", "id": "UpdateInfo" }, "OperationError": { "type": "object", "properties": { "errorType": { "type": "string", "enumDescriptions": [ "UNSPECIFIED means product type is not known or available.", "key destroyed, expired, not found, unreachable or permission denied.", "Database is not accessible", "The zone or region does not have sufficient resources to handle the request at the moment", "User initiated cancellation", "SQL server specific error", "Any other internal error." ], "enum": [ "OPERATION_ERROR_TYPE_UNSPECIFIED", "KMS_KEY_ERROR", "DATABASE_ERROR", "STOCKOUT_ERROR", "CANCELLATION_ERROR", "SQLSERVER_ERROR", "INTERNAL_ERROR" ] }, "message": { "type": "string", "description": "Additional information about the error encountered. REQUIRED" }, "code": { "type": "string", "description": "Identifies the specific error that occurred. REQUIRED" } }, "description": "An error that occurred during a backup creation operation.", "id": "OperationError" }, "InputConfig": { "description": "The input content", "type": "object", "properties": { "gcsSource": { "$ref": "GcsSource", "description": "Google Cloud Storage location where input content is located." } }, "id": "InputConfig" }, "TlsCertificate": { "id": "TlsCertificate", "type": "object", "properties": { "createTime": { "type": "string", "description": "Output only. The time when the certificate was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2020-05-18T00:00:00.094Z`.", "format": "google-datetime", "readOnly": true }, "expireTime": { "type": "string", "description": "Output only. The time when the certificate expires in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2020-05-18T00:00:00.094Z`.", "format": "google-datetime", "readOnly": true }, "serialNumber": { "type": "string", "description": "Serial number, as extracted from the certificate." }, "cert": { "type": "string", "description": "PEM representation." }, "sha1Fingerprint": { "type": "string", "description": "Sha1 Fingerprint of the certificate." } }, "description": "TlsCertificate Resource" }, "PscAutoConnection": { "type": "object", "properties": { "pscConnectionId": { "readOnly": true, "type": "string", "description": "Output only. The PSC connection id of the forwarding rule connected to the service attachment." }, "forwardingRule": { "type": "string", "description": "Output only. The URI of the consumer side forwarding rule. Example: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.", "readOnly": true }, "serviceAttachment": { "readOnly": true, "description": "Output only. The service attachment which is the target of the PSC connection, in the form of projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.", "type": "string" }, "pscConnectionStatus": { "enumDescriptions": [ "PSC connection status is not specified.", "The connection is active", "Connection not found" ], "type": "string", "description": "Output only. The status of the PSC connection. Please note that this value is updated periodically. Please use Private Service Connect APIs for the latest status.", "readOnly": true, "enum": [ "PSC_CONNECTION_STATUS_UNSPECIFIED", "PSC_CONNECTION_STATUS_ACTIVE", "PSC_CONNECTION_STATUS_NOT_FOUND" ] }, "connectionType": { "enum": [ "CONNECTION_TYPE_UNSPECIFIED", "CONNECTION_TYPE_DISCOVERY", "CONNECTION_TYPE_PRIMARY", "CONNECTION_TYPE_READER" ], "readOnly": true, "description": "Output only. Type of the PSC connection.", "type": "string", "enumDescriptions": [ "Cluster endpoint Type is not set", "Cluster endpoint that will be used as for cluster topology discovery.", "Cluster endpoint that will be used as primary endpoint to access primary.", "Cluster endpoint that will be used as reader endpoint to access replicas." ] }, "address": { "readOnly": true, "description": "Output only. The IP allocated on the consumer network for the PSC forwarding rule.", "type": "string" }, "projectId": { "description": "Required. The consumer project_id where the forwarding rule is created from.", "type": "string" }, "network": { "description": "Required. The consumer network where the IP address resides, in the form of projects/{project_id}/global/networks/{network_id}.", "type": "string" } }, "description": "Details of consumer resources in a PSC connection that is created through Service Connectivity Automation.", "id": "PscAutoConnection" }, "PersistenceConfig": { "id": "PersistenceConfig", "description": "Configuration of the persistence functionality.", "type": "object", "properties": { "rdbSnapshotPeriod": { "enumDescriptions": [ "Not set.", "Snapshot every 1 hour.", "Snapshot every 6 hours.", "Snapshot every 12 hours.", "Snapshot every 24 hours." ], "enum": [ "SNAPSHOT_PERIOD_UNSPECIFIED", "ONE_HOUR", "SIX_HOURS", "TWELVE_HOURS", "TWENTY_FOUR_HOURS" ], "description": "Optional. Period between RDB snapshots. Snapshots will be attempted every period starting from the provided snapshot start time. For example, a start time of 01/01/2033 06:45 and SIX_HOURS snapshot period will do nothing until 01/01/2033, and then trigger snapshots every day at 06:45, 12:45, 18:45, and 00:45 the next day, and so on. If not provided, TWENTY_FOUR_HOURS will be used as default.", "type": "string" }, "rdbSnapshotStartTime": { "description": "Optional. Date and time that the first snapshot was/will be attempted, and to which future snapshots will be aligned. If not provided, the current time will be used.", "format": "google-datetime", "type": "string" }, "persistenceMode": { "enumDescriptions": [ "Not set.", "Persistence is disabled for the instance, and any existing snapshots are deleted.", "RDB based Persistence is enabled." ], "enum": [ "PERSISTENCE_MODE_UNSPECIFIED", "DISABLED", "RDB" ], "type": "string", "description": "Optional. Controls whether Persistence features are enabled. If not provided, the existing value will be used." }, "rdbNextSnapshotTime": { "type": "string", "description": "Output only. The next time that a snapshot attempt is scheduled to occur.", "format": "google-datetime", "readOnly": true } } }, "ResourceMaintenanceSchedule": { "id": "ResourceMaintenanceSchedule", "description": "Maintenance window for the database resource. It specifies preferred time and day of the week and phase in some cases, when the maintenance can start. This is configured by the customer.", "type": "object", "properties": { "time": { "description": "Optional. Preferred time to start the maintenance operation on the specified day.", "$ref": "TimeOfDay" }, "phase": { "enumDescriptions": [ "Phase is unspecified.", "Any phase.", "Week 1.", "Week 2.", "Week 5." ], "enum": [ "PHASE_UNSPECIFIED", "ANY", "WEEK1", "WEEK2", "WEEK5" ], "type": "string", "description": "Optional. Phase of the maintenance window. This is to capture order of maintenance. For example, for Cloud SQL resources, this can be used to capture if the maintenance window is in Week1, Week2, Week5, etc. Non production resources are usually part of early phase. For more details, refer to Cloud SQL resources - https://cloud.google.com/sql/docs/mysql/maintenance" }, "day": { "description": "Optional. Preferred day of the week for maintenance, e.g. MONDAY, TUESDAY, etc.", "type": "string", "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ] } } }, "Backup": { "id": "Backup", "description": "Backup of a cluster.", "type": "object", "properties": { "shardCount": { "description": "Output only. Number of shards for the cluster.", "format": "int32", "type": "integer", "readOnly": true }, "totalSizeBytes": { "description": "Output only. Total size of the backup in bytes.", "format": "int64", "type": "string", "readOnly": true }, "engineVersion": { "description": "Output only. redis-7.2, valkey-7.5", "type": "string", "readOnly": true }, "backupType": { "enumDescriptions": [ "The default value, not set.", "On-demand backup.", "Automated backup." ], "readOnly": true, "enum": [ "BACKUP_TYPE_UNSPECIFIED", "ON_DEMAND", "AUTOMATED" ], "type": "string", "description": "Output only. Type of the backup." }, "clusterUid": { "type": "string", "description": "Output only. Cluster uid of this backup.", "readOnly": true }, "replicaCount": { "type": "integer", "description": "Output only. Number of replicas for the cluster.", "format": "int32", "readOnly": true }, "createTime": { "type": "string", "description": "Output only. The time when the backup was created.", "format": "google-datetime", "readOnly": true }, "cluster": { "readOnly": true, "description": "Output only. Cluster resource path of this backup.", "type": "string" }, "backupFiles": { "type": "array", "description": "Output only. List of backup files of the backup.", "items": { "$ref": "BackupFile" }, "readOnly": true }, "encryptionInfo": { "readOnly": true, "$ref": "EncryptionInfo", "description": "Output only. Encryption information of the backup." }, "nodeType": { "enumDescriptions": [ "Node type unspecified", "Redis shared core nano node_type.", "Redis highmem medium node_type.", "Redis highmem xlarge node_type.", "Redis standard small node_type.", "Redis highcpu medium node_type.", "Redis standard large node_type.", "Redis highmem 2xlarge node_type." ], "type": "string", "description": "Output only. Node type of the cluster.", "readOnly": true, "enum": [ "NODE_TYPE_UNSPECIFIED", "REDIS_SHARED_CORE_NANO", "REDIS_HIGHMEM_MEDIUM", "REDIS_HIGHMEM_XLARGE", "REDIS_STANDARD_SMALL", "REDIS_HIGHCPU_MEDIUM", "REDIS_STANDARD_LARGE", "REDIS_HIGHMEM_2XLARGE" ] }, "uid": { "readOnly": true, "description": "Output only. System assigned unique identifier of the backup.", "type": "string" }, "name": { "type": "string", "description": "Identifier. Full resource path of the backup. the last part of the name is the backup id with the following format: [YYYYMMDDHHMMSS]_[Shorted Cluster UID] OR customer specified while backup cluster. Example: 20240515123000_1234" }, "expireTime": { "description": "Output only. The time when the backup will expire.", "format": "google-datetime", "type": "string", "readOnly": true }, "state": { "enumDescriptions": [ "The default value, not set.", "The backup is being created.", "The backup is active to be used.", "The backup is being deleted.", "The backup is currently suspended due to reasons like project deletion, billing account closure, etc." ], "description": "Output only. State of the backup.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "SUSPENDED" ], "readOnly": true } } }, "Tags": { "description": "Message type for storing tags. Tags provide a way to create annotations for resources, and in some cases conditionally allow or deny policies based on whether a resource has a specific tag.", "type": "object", "properties": { "tags": { "type": "object", "description": "The Tag key/value mappings.", "additionalProperties": { "type": "string" } } }, "id": "Tags" }, "ObservabilityMetricData": { "id": "ObservabilityMetricData", "type": "object", "properties": { "value": { "description": "Required. Value of the metric type.", "$ref": "TypedValue" }, "metricType": { "enumDescriptions": [ "Unspecified metric type.", "CPU utilization for a resource. The value is a fraction between 0.0 and 1.0 (may momentarily exceed 1.0 in some cases).", "Memory utilization for a resource. The value is a fraction between 0.0 and 1.0 (may momentarily exceed 1.0 in some cases).", "Number of network connections for a resource.", "Storage utilization for a resource. The value is a fraction between 0.0 and 1.0 (may momentarily exceed 1.0 in some cases).", "Sotrage used by a resource.", "Node count for a resource. It represents the number of node units in a bigtable/spanner instance.", "Memory used by a resource (in bytes).", "Processing units used by a resource. It represents the number of processing units in a spanner instance." ], "enum": [ "METRIC_TYPE_UNSPECIFIED", "CPU_UTILIZATION", "MEMORY_UTILIZATION", "NETWORK_CONNECTIONS", "STORAGE_UTILIZATION", "STORAGE_USED_BYTES", "NODE_COUNT", "MEMORY_USED_BYTES", "PROCESSING_UNIT_COUNT" ], "description": "Required. Type of metric like CPU, Memory, etc.", "type": "string" }, "resourceName": { "type": "string", "description": "Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel" }, "aggregationType": { "enumDescriptions": [ "Unspecified aggregation type.", "PEAK aggregation type.", "P99 aggregation type.", "P95 aggregation type.", "current aggregation type." ], "enum": [ "AGGREGATION_TYPE_UNSPECIFIED", "PEAK", "P99", "P95", "CURRENT" ], "description": "Required. Type of aggregation performed on the metric.", "type": "string" }, "observationTime": { "description": "Required. The time the metric value was observed.", "format": "google-datetime", "type": "string" } } }, "DatabaseResourceRecommendationSignalData": { "description": "Common model for database resource recommendation signal data.", "type": "object", "properties": { "resourceName": { "description": "Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", "type": "string" }, "recommenderId": { "type": "string", "description": "Required. ID of recommender. Examples: \"google.cloudsql.instance.PerformanceRecommender\"" }, "recommendationState": { "description": "Required. Recommendation state", "type": "string", "enumDescriptions": [ "", "Recommendation is active and can be applied. ACTIVE recommendations can be marked as CLAIMED, SUCCEEDED, or FAILED.", "Recommendation is in claimed state. Recommendations content is immutable and cannot be updated by Google. CLAIMED recommendations can be marked as CLAIMED, SUCCEEDED, or FAILED.", "Recommendation is in succeeded state. Recommendations content is immutable and cannot be updated by Google. SUCCEEDED recommendations can be marked as SUCCEEDED, or FAILED.", "Recommendation is in failed state. Recommendations content is immutable and cannot be updated by Google. FAILED recommendations can be marked as SUCCEEDED, or FAILED.", "Recommendation is in dismissed state. Recommendation content can be updated by Google. DISMISSED recommendations can be marked as ACTIVE." ], "enum": [ "UNSPECIFIED", "ACTIVE", "CLAIMED", "SUCCEEDED", "FAILED", "DISMISSED" ] }, "signalType": { "enum": [ "SIGNAL_TYPE_UNSPECIFIED", "SIGNAL_TYPE_NOT_PROTECTED_BY_AUTOMATIC_FAILOVER", "SIGNAL_TYPE_GROUP_NOT_REPLICATING_ACROSS_REGIONS", "SIGNAL_TYPE_NOT_AVAILABLE_IN_MULTIPLE_ZONES", "SIGNAL_TYPE_NOT_AVAILABLE_IN_MULTIPLE_REGIONS", "SIGNAL_TYPE_NO_PROMOTABLE_REPLICA", "SIGNAL_TYPE_NO_AUTOMATED_BACKUP_POLICY", "SIGNAL_TYPE_SHORT_BACKUP_RETENTION", "SIGNAL_TYPE_LAST_BACKUP_FAILED", "SIGNAL_TYPE_LAST_BACKUP_OLD", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_2_0", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_3", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_2", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_1", "SIGNAL_TYPE_VIOLATES_CIS_GCP_FOUNDATION_1_0", "SIGNAL_TYPE_VIOLATES_CIS_CONTROLS_V8_0", "SIGNAL_TYPE_VIOLATES_NIST_800_53", "SIGNAL_TYPE_VIOLATES_NIST_800_53_R5", "SIGNAL_TYPE_VIOLATES_NIST_CYBERSECURITY_FRAMEWORK_V1_0", "SIGNAL_TYPE_VIOLATES_ISO_27001", "SIGNAL_TYPE_VIOLATES_ISO_27001_V2022", "SIGNAL_TYPE_VIOLATES_PCI_DSS_V3_2_1", "SIGNAL_TYPE_VIOLATES_PCI_DSS_V4_0", "SIGNAL_TYPE_VIOLATES_CLOUD_CONTROLS_MATRIX_V4", "SIGNAL_TYPE_VIOLATES_HIPAA", "SIGNAL_TYPE_VIOLATES_SOC2_V2017", "SIGNAL_TYPE_LOGS_NOT_OPTIMIZED_FOR_TROUBLESHOOTING", "SIGNAL_TYPE_QUERY_DURATIONS_NOT_LOGGED", "SIGNAL_TYPE_VERBOSE_ERROR_LOGGING", "SIGNAL_TYPE_QUERY_LOCK_WAITS_NOT_LOGGED", "SIGNAL_TYPE_LOGGING_MOST_ERRORS", "SIGNAL_TYPE_LOGGING_ONLY_CRITICAL_ERRORS", "SIGNAL_TYPE_MINIMAL_ERROR_LOGGING", "SIGNAL_TYPE_QUERY_STATISTICS_LOGGED", "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_CLIENT_HOSTNAME", "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_PARSER_STATISTICS", "SIGNAL_TYPE_EXCESSIVE_LOGGING_OF_PLANNER_STATISTICS", "SIGNAL_TYPE_NOT_LOGGING_ONLY_DDL_STATEMENTS", "SIGNAL_TYPE_LOGGING_QUERY_STATISTICS", "SIGNAL_TYPE_NOT_LOGGING_TEMPORARY_FILES", "SIGNAL_TYPE_CONNECTION_MAX_NOT_CONFIGURED", "SIGNAL_TYPE_USER_OPTIONS_CONFIGURED", "SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", "SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS", "SIGNAL_TYPE_NO_ROOT_PASSWORD", "SIGNAL_TYPE_WEAK_ROOT_PASSWORD", "SIGNAL_TYPE_ENCRYPTION_KEY_NOT_CUSTOMER_MANAGED", "SIGNAL_TYPE_SERVER_AUTHENTICATION_NOT_REQUIRED", "SIGNAL_TYPE_EXPOSED_BY_OWNERSHIP_CHAINING", "SIGNAL_TYPE_EXPOSED_TO_EXTERNAL_SCRIPTS", "SIGNAL_TYPE_EXPOSED_TO_LOCAL_DATA_LOADS", "SIGNAL_TYPE_CONNECTION_ATTEMPTS_NOT_LOGGED", "SIGNAL_TYPE_DISCONNECTIONS_NOT_LOGGED", "SIGNAL_TYPE_LOGGING_EXCESSIVE_STATEMENT_INFO", "SIGNAL_TYPE_EXPOSED_TO_REMOTE_ACCESS", "SIGNAL_TYPE_DATABASE_NAMES_EXPOSED", "SIGNAL_TYPE_SENSITIVE_TRACE_INFO_NOT_MASKED", "SIGNAL_TYPE_PUBLIC_IP_ENABLED", "SIGNAL_TYPE_IDLE", "SIGNAL_TYPE_OVERPROVISIONED", "SIGNAL_TYPE_HIGH_NUMBER_OF_OPEN_TABLES", "SIGNAL_TYPE_HIGH_NUMBER_OF_TABLES", "SIGNAL_TYPE_HIGH_TRANSACTION_ID_UTILIZATION", "SIGNAL_TYPE_UNDERPROVISIONED", "SIGNAL_TYPE_OUT_OF_DISK", "SIGNAL_TYPE_SERVER_CERTIFICATE_NEAR_EXPIRY", "SIGNAL_TYPE_DATABASE_AUDITING_DISABLED", "SIGNAL_TYPE_RESTRICT_AUTHORIZED_NETWORKS", "SIGNAL_TYPE_VIOLATE_POLICY_RESTRICT_PUBLIC_IP", "SIGNAL_TYPE_QUOTA_LIMIT", "SIGNAL_TYPE_NO_PASSWORD_POLICY", "SIGNAL_TYPE_CONNECTIONS_PERFORMANCE_IMPACT", "SIGNAL_TYPE_TMP_TABLES_PERFORMANCE_IMPACT", "SIGNAL_TYPE_TRANS_LOGS_PERFORMANCE_IMPACT", "SIGNAL_TYPE_HIGH_JOINS_WITHOUT_INDEXES", "SIGNAL_TYPE_SUPERUSER_WRITING_TO_USER_TABLES", "SIGNAL_TYPE_USER_GRANTED_ALL_PERMISSIONS", "SIGNAL_TYPE_DATA_EXPORT_TO_EXTERNAL_CLOUD_STORAGE_BUCKET", "SIGNAL_TYPE_DATA_EXPORT_TO_PUBLIC_CLOUD_STORAGE_BUCKET", "SIGNAL_TYPE_WEAK_PASSWORD_HASH_ALGORITHM", "SIGNAL_TYPE_NO_USER_PASSWORD_POLICY", "SIGNAL_TYPE_HOT_NODE", "SIGNAL_TYPE_NO_POINT_IN_TIME_RECOVERY", "SIGNAL_TYPE_RESOURCE_SUSPENDED", "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", "SIGNAL_TYPE_NO_DELETION_PROTECTION", "SIGNAL_TYPE_INEFFICIENT_QUERY", "SIGNAL_TYPE_READ_INTENSIVE_WORKLOAD", "SIGNAL_TYPE_MEMORY_LIMIT", "SIGNAL_TYPE_MAX_SERVER_MEMORY", "SIGNAL_TYPE_LARGE_ROWS", "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", "SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", "SIGNAL_TYPE_OUTDATED_MINOR_VERSION", "SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", "SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", "SIGNAL_TYPE_REPLICATION_LAG", "SIGNAL_TYPE_OUTDATED_VERSION", "SIGNAL_TYPE_OUTDATED_CLIENT", "SIGNAL_TYPE_DATABOOST_DISABLED", "SIGNAL_TYPE_RECOMMENDED_MAINTENANCE_POLICIES", "SIGNAL_TYPE_EXTENDED_SUPPORT", "SIGNAL_TYPE_PERFORMANCE_KPI_CHANGE", "SIGNAL_TYPE_VERSION_NEARING_END_OF_LIFE" ], "description": "Required. Type of signal, for example, `SIGNAL_TYPE_IDLE`, `SIGNAL_TYPE_HIGH_NUMBER_OF_TABLES`, etc.", "type": "string", "enumDeprecated": [ false, false, false, true, true, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, false ], "enumDescriptions": [ "Unspecified.", "Represents if a resource is protected by automatic failover. Checks for resources that are configured to have redundancy within a region that enables automatic failover.", "Represents if a group is replicating across regions. Checks for resources that are configured to have redundancy, and ongoing replication, across regions.", "Represents if the resource is available in multiple zones or not.", "Represents if a resource is available in multiple regions.", "Represents if a resource has a promotable replica.", "Represents if a resource has an automated backup policy.", "Represents if a resources has a short backup retention period.", "Represents if the last backup of a resource failed.", "Represents if the last backup of a resource is older than some threshold value.", "Represents if a resource violates CIS GCP Foundation 2.0.", "Represents if a resource violates CIS GCP Foundation 1.3.", "Represents if a resource violates CIS GCP Foundation 1.2.", "Represents if a resource violates CIS GCP Foundation 1.1.", "Represents if a resource violates CIS GCP Foundation 1.0.", "Represents if a resource violates CIS Controls 8.0.", "Represents if a resource violates NIST 800-53.", "Represents if a resource violates NIST 800-53 R5.", "Represents if a resource violates NIST Cybersecurity Framework 1.0.", "Represents if a resource violates ISO-27001.", "Represents if a resource violates ISO 27001 2022.", "Represents if a resource violates PCI-DSS v3.2.1.", "Represents if a resource violates PCI-DSS v4.0.", "Represents if a resource violates Cloud Controls Matrix v4.0.", "Represents if a resource violates HIPAA.", "Represents if a resource violates SOC2 v2017.", "Represents if log_checkpoints database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_duration database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_error_verbosity database flag for a Cloud SQL for PostgreSQL instance is not set to default or stricter (default or terse).", "Represents if the log_lock_waits database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_min_error_statement database flag for a Cloud SQL for PostgreSQL instance is not set appropriately.", "Represents if the log_min_error_statement database flag for a Cloud SQL for PostgreSQL instance does not have an appropriate severity level.", "Represents if the log_min_messages database flag for a Cloud SQL for PostgreSQL instance is not set to warning or another recommended value.", "Represents if the databaseFlags property of instance metadata for the log_executor_status field is set to on.", "Represents if the log_hostname database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_parser_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_planner_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_statement database flag for a Cloud SQL for PostgreSQL instance is not set to DDL (all data definition statements).", "Represents if the log_statement_stats database flag for a Cloud SQL for PostgreSQL instance is not set to off.", "Represents if the log_temp_files database flag for a Cloud SQL for PostgreSQL instance is not set to \"0\". (NOTE: 0 = ON)", "Represents if the user connections database flag for a Cloud SQL for SQL Server instance is configured.", "Represents if the user options database flag for Cloud SQL SQL Server instance is configured or not.", "Represents if a resource is exposed to public access.", "Represents if a resources requires all incoming connections to use SSL or not.", "Represents if a Cloud SQL database has a password configured for the root account or not.", "Represents if a Cloud SQL database has a weak password configured for the root account.", "Represents if a SQL database instance is not encrypted with customer-managed encryption keys (CMEK).", "Represents if The contained database authentication database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if the cross_db_ownership_chaining database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if he external scripts enabled database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if the local_infile database flag for a Cloud SQL for MySQL instance is not set to off.", "Represents if the log_connections database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_disconnections database flag for a Cloud SQL for PostgreSQL instance is not set to on.", "Represents if the log_min_duration_statement database flag for a Cloud SQL for PostgreSQL instance is not set to -1.", "Represents if the remote access database flag for a Cloud SQL for SQL Server instance is not set to off.", "Represents if the skip_show_database database flag for a Cloud SQL for MySQL instance is not set to on.", "Represents if the 3625 (trace flag) database flag for a Cloud SQL for SQL Server instance is not set to on.", "Represents if public IP is enabled.", "Represents Idle instance helps to reduce costs.", "Represents instances that are unnecessarily large for given workload.", "Represents high number of concurrently opened tables.", "Represents high table count close to SLA limit.", "Represents high number of unvacuumed transactions", "Represents need for more CPU and/or memory", "Represents out of disk.", "Represents server certificate is near expiry.", "Represents database auditing is disabled.", "Represents not restricted to authorized networks.", "Represents violate org policy restrict public ip.", "Cluster nearing quota limit", "No password policy set on resources", "Performance impact of connections settings", "Performance impact of temporary tables settings", "Performance impact of transaction logs settings", "Performance impact of high joins without indexes", "Detects events where a Cloud SQL superuser (postgres for PostgreSQL servers or root for MySQL users) writes to non-system tables.", "Detects events where a database user or role has been granted all privileges to a database, or to all tables, procedures, or functions in a schema.", "Detects if database instance data exported to a Cloud Storage bucket outside of the organization.", "Detects if database instance data exported to a Cloud Storage bucket that is owned by the organization and is publicly accessible.", "Detects if a database instance is using a weak password hash algorithm.", "Detects if a database instance has no user password policy set.", "Detects if a database instance/cluster has a hot node.", "Detects if a database instance has no point in time recovery enabled.", "Detects if a database instance/cluster is suspended.", "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", "Deletion Protection Disabled for the resource", "Indicates that the instance has inefficient queries detected.", "Indicates that the instance has read intensive workload.", "Indicates that the instance is nearing memory limit.", "Indicates that the instance's max server memory is configured higher than the recommended value.", "Indicates that the database has large rows beyond the recommended limit.", "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", "Location org policy not satisfied.", "Outdated DB minor version.", "Schema not optimized.", "High number of idle connections.", "Replication delay.", "Outdated version.", "Outdated client.", "Databoost is disabled.", "Recommended maintenance policy.", "Resource version is in extended support.", "Change in performance KPIs.", "Database version nearing end of life." ] }, "additionalMetadata": { "type": "object", "description": "Optional. Any other additional metadata specific to recommendation", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "recommenderSubtype": { "type": "string", "description": "Required. Contains an identifier for a subtype of recommendations produced for the same recommender. Subtype is a function of content and impact, meaning a new subtype might be added when significant changes to `content` or `primary_impact.category` are introduced. See the Recommenders section to see a list of subtypes for a given Recommender. Examples: For recommender = \"google.cloudsql.instance.PerformanceRecommender\", recommender_subtype can be \"MYSQL_HIGH_NUMBER_OF_OPEN_TABLES_BEST_PRACTICE\"/\"POSTGRES_HIGH_TRANSACTION_ID_UTILIZATION_BEST_PRACTICE\"" }, "lastRefreshTime": { "description": "Required. last time recommendationw as refreshed", "format": "google-datetime", "type": "string" }, "recommender": { "description": "Required. Name of recommendation. Examples: organizations/1234/locations/us-central1/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations/9876", "type": "string" } }, "id": "DatabaseResourceRecommendationSignalData" }, "AddAuthTokenRequest": { "id": "AddAuthTokenRequest", "description": "Request message for AddAuthToken.", "type": "object", "properties": { "authToken": { "description": "Required. The auth token to add.", "$ref": "AuthToken" } } }, "Operation": { "id": "Operation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "properties": { "metadata": { "type": "object", "description": "{ `createTime`: The time the operation was created. `endTime`: The time the operation finished running. `target`: Server-defined resource path for the target of the operation. `verb`: Name of the verb executed by the operation. `statusDetail`: Human-readable status of the operation, if any. `cancelRequested`: 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`. `apiVersion`: API version used to start the operation. }", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "response": { "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object" }, "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "done": { "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", "type": "boolean" } } } }, "discoveryVersion": "v1", "name": "redis", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/redis.read-write": { "description": "See, edit, configure, and delete your Google Cloud Memorystore for Redis data and see the email address for your Google Account" }, "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "https://www.googleapis.com/auth/redis.read-only": { "description": "See your Google Cloud Memorystore for Redis data and the email address of your Google Account" } } } }, "batchPath": "batch", "version_module": true, "documentationLink": "https://cloud.google.com/memorystore/docs/redis/", "title": "Google Cloud Memorystore for Redis API", "protocol": "rest", "id": "redis:v1beta1", "revision": "20260427", "fullyEncodeReservedExpansion": true, "canonicalName": "Cloud Redis", "basePath": "", "resources": { "projects": { "resources": { "locations": { "methods": { "getSharedRegionalCertificateAuthority": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/sharedRegionalCertificateAuthority", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. Regional certificate authority resource name using the form: `projects/{project_id}/locations/{location_id}/sharedRegionalCertificateAuthority` where `location_id` refers to a Google Cloud region.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/sharedRegionalCertificateAuthority$", "required": true } }, "id": "redis.projects.locations.getSharedRegionalCertificateAuthority", "response": { "$ref": "SharedRegionalCertificateAuthority" }, "description": "Gets the details of regional certificate authority information for Redis cluster.", "path": "v1beta1/{+name}" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.list", "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "The resource that owns the locations collection, if applicable.", "location": "path", "pattern": "^projects/[^/]+$", "required": true }, "extraLocationTypes": { "repeated": true, "type": "string", "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.", "location": "query" }, "pageSize": { "type": "integer", "description": "The maximum number of results to return. If not set, the service selects a default.", "format": "int32", "location": "query" }, "pageToken": { "type": "string", "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query" }, "filter": { "location": "query", "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "type": "string" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations", "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", "path": "v1beta1/{+name}/locations", "response": { "$ref": "ListLocationsResponse" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "description": "Resource name for the location.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true } }, "id": "redis.projects.locations.get", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}", "description": "Gets information about a location.", "path": "v1beta1/{+name}", "response": { "$ref": "Location" } } }, "resources": { "backupCollections": { "methods": { "list": { "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/backupCollections", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "GET", "parameters": { "pageSize": { "location": "query", "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's `next_page_token` to determine if there are more clusters left to be queried.", "format": "int32", "type": "integer" }, "pageToken": { "description": "Optional. The `next_page_token` value returned from a previous [ListBackupCollections] request, if any.", "type": "string", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string", "description": "Required. The resource name of the backupCollection location using the form: `projects/{project_id}/locations/{location_id}` where `location_id` refers to a Google Cloud region.", "location": "path" } }, "id": "redis.projects.locations.backupCollections.list", "response": { "$ref": "ListBackupCollectionsResponse" }, "description": "Lists all backup collections owned by a consumer project in either the specified location (region) or all locations. If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.", "path": "v1beta1/{+parent}/backupCollections" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.backupCollections.get", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Redis backupCollection resource name using the form: `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}` where `location_id` refers to a Google Cloud region.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupCollections/[^/]+$", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/backupCollections/{backupCollectionsId}", "description": "Get a backup collection.", "path": "v1beta1/{+name}", "response": { "$ref": "BackupCollection" } } }, "resources": { "backups": { "methods": { "list": { "response": { "$ref": "ListBackupsResponse" }, "description": "Lists all backups owned by a backup collection.", "path": "v1beta1/{+parent}/backups", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/backupCollections/{backupCollectionsId}/backups", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.backupCollections.backups.list", "httpMethod": "GET", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/backupCollections/[^/]+$", "required": true, "type": "string", "description": "Required. The resource name of the backupCollection using the form: `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}`", "location": "path" }, "pageSize": { "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's `next_page_token` to determine if there are more clusters left to be queried.", "format": "int32", "type": "integer", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. The `next_page_token` value returned from a previous [ListBackupCollections] request, if any.", "location": "query" } } }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/backupCollections/{backupCollectionsId}/backups/{backupsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.backupCollections.backups.get", "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "Required. Redis backup resource name using the form: `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}/backups/{backup_id}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupCollections/[^/]+/backups/[^/]+$", "required": true } }, "response": { "$ref": "Backup" }, "description": "Gets the details of a specific backup.", "path": "v1beta1/{+name}" }, "delete": { "response": { "$ref": "Operation" }, "description": "Deletes a specific backup.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/backupCollections/{backupCollectionsId}/backups/{backupsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "DELETE", "parameters": { "requestId": { "type": "string", "description": "Optional. Idempotent request UUID.", "location": "query" }, "name": { "description": "Required. Redis backup resource name using the form: `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}/backups/{backup_id}`", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupCollections/[^/]+/backups/[^/]+$", "required": true } }, "id": "redis.projects.locations.backupCollections.backups.delete" }, "export": { "description": "Exports a specific backup to a customer target Cloud Storage URI.", "path": "v1beta1/{+name}:export", "request": { "$ref": "ExportBackupRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.backupCollections.backups.export", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/backupCollections/[^/]+/backups/[^/]+$", "required": true, "type": "string", "description": "Required. Redis backup resource name using the form: `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}/backups/{backup_id}`", "location": "path" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/backupCollections/{backupCollectionsId}/backups/{backupsId}:export" } } } } }, "clusters": { "methods": { "delete": { "description": "Deletes a specific Redis cluster. Cluster stops serving and data is deleted.", "path": "v1beta1/{+name}", "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "DELETE", "parameters": { "requestId": { "type": "string", "description": "Optional. Idempotent request UUID.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", "required": true, "location": "path", "description": "Required. Redis cluster resource name using the form: `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}` where `location_id` refers to a Google Cloud region.", "type": "string" } }, "id": "redis.projects.locations.clusters.delete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}" }, "backup": { "path": "v1beta1/{+name}:backup", "description": "Backup Redis Cluster. If this is the first time a backup is being created, a backup collection will be created at the backend, and this backup belongs to this collection. Both collection and backup will have a resource name. Backup will be executed for each shard. A replica (primary if nonHA) will be selected to perform the execution. Backup call will be rejected if there is an ongoing backup or update operation. Be aware that during preview, if the cluster's internal software version is too old, critical update will be performed before actual backup. Once the internal software version is updated to the minimum version required by the backup feature, subsequent backups will not require critical update. After preview, there will be no critical update needed for backup.", "request": { "$ref": "BackupClusterRequest" }, "response": { "$ref": "Operation" }, "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", "required": true, "description": "Required. Redis cluster resource name using the form: `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}` where `location_id` refers to a Google Cloud region.", "type": "string", "location": "path" } }, "id": "redis.projects.locations.clusters.backup", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:backup", "parameterOrder": [ "name" ] }, "addTokenAuthUser": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.clusters.addTokenAuthUser", "httpMethod": "POST", "parameters": { "cluster": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", "required": true, "type": "string", "description": "Required. The cluster resource that this token auth user will be added for. Format: projects/{project}/locations/{location}/clusters/{cluster}", "location": "path" } }, "parameterOrder": [ "cluster" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:addTokenAuthUser", "description": "Adds a token auth user for a token based auth enabled cluster.", "path": "v1beta1/{+cluster}:addTokenAuthUser", "request": { "$ref": "AddTokenAuthUserRequest" }, "response": { "$ref": "Operation" } }, "create": { "id": "redis.projects.locations.clusters.create", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The resource name of the cluster location using the form: `projects/{project_id}/locations/{location_id}` where `location_id` refers to a Google Cloud region.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "clusterId": { "type": "string", "description": "Required. The logical name of the Redis cluster in the customer project with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the customer project / location", "location": "query" }, "requestId": { "location": "query", "type": "string", "description": "Optional. Idempotent request UUID." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/clusters", "description": "Creates a Redis cluster based on the specified properties. The creation is executed asynchronously and callers may check the returned operation to track its progress. Once the operation is completed the Redis cluster will be fully functional. The completed longrunning.Operation will contain the new cluster object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.", "request": { "$ref": "Cluster" }, "response": { "$ref": "Operation" } }, "rescheduleClusterMaintenance": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:rescheduleClusterMaintenance", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "description": "Required. Redis Cluster instance resource name using the form: `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}` where `location_id` refers to a Google Cloud region.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", "required": true } }, "id": "redis.projects.locations.clusters.rescheduleClusterMaintenance", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "request": { "$ref": "RescheduleClusterMaintenanceRequest" }, "response": { "$ref": "Operation" }, "path": "v1beta1/{+name}:rescheduleClusterMaintenance", "description": "Reschedules upcoming maintenance event." }, "list": { "id": "redis.projects.locations.clusters.list", "httpMethod": "GET", "parameters": { "pageSize": { "description": "The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's `next_page_token` to determine if there are more clusters left to be queried.", "format": "int32", "type": "integer", "location": "query" }, "pageToken": { "location": "query", "description": "The `next_page_token` value returned from a previous `ListClusters` request, if any.", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string", "description": "Required. The resource name of the cluster location using the form: `projects/{project_id}/locations/{location_id}` where `location_id` refers to a Google Cloud region.", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/clusters", "description": "Lists all Redis clusters owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.", "response": { "$ref": "ListClustersResponse" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}", "parameterOrder": [ "name" ], "id": "redis.projects.locations.clusters.get", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Required. Redis cluster resource name using the form: `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}` where `location_id` refers to a Google Cloud region." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "response": { "$ref": "Cluster" }, "path": "v1beta1/{+name}", "description": "Gets the details of a specific Redis cluster." }, "patch": { "request": { "$ref": "Cluster" }, "response": { "$ref": "Operation" }, "description": "Updates the metadata and configuration of a specific Redis cluster. Completed longrunning.Operation will contain the new cluster object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "PATCH", "parameters": { "updateMask": { "type": "string", "description": "Required. Mask of fields to update. At least one path must be supplied in this field. The elements of the repeated paths field may only include these fields from Cluster: * `size_gb` * `replica_count` * `cluster_endpoints`", "format": "google-fieldmask", "location": "query" }, "requestId": { "location": "query", "type": "string", "description": "Optional. Idempotent request UUID." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Required. Identifier. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}`" } }, "id": "redis.projects.locations.clusters.patch" }, "getCertificateAuthority": { "path": "v1beta1/{+name}", "description": "Gets the details of certificate authority information for Redis cluster.", "response": { "$ref": "CertificateAuthority" }, "id": "redis.projects.locations.clusters.getCertificateAuthority", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. Redis cluster certificate authority resource name using the form: `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}/certificateAuthority` where `location_id` refers to a Google Cloud region.", "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/certificateAuthority$", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/certificateAuthority", "parameterOrder": [ "name" ] } }, "resources": { "tokenAuthUsers": { "methods": { "addAuthToken": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/tokenAuthUsers/{tokenAuthUsersId}:addAuthToken", "parameterOrder": [ "tokenAuthUser" ], "id": "redis.projects.locations.clusters.tokenAuthUsers.addAuthToken", "httpMethod": "POST", "parameters": { "tokenAuthUser": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/tokenAuthUsers/[^/]+$", "required": true, "description": "Required. The name of the token auth user resource that this auth token will be added for. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}", "type": "string", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "request": { "$ref": "AddAuthTokenRequest" }, "response": { "$ref": "Operation" }, "path": "v1beta1/{+tokenAuthUser}:addAuthToken", "description": "Adds a auth token for a user of a token based auth enabled cluster." }, "list": { "path": "v1beta1/{+parent}/tokenAuthUsers", "description": "Lists all the token auth users for a token based auth enabled cluster.", "response": { "$ref": "ListTokenAuthUsersResponse" }, "httpMethod": "GET", "parameters": { "filter": { "location": "query", "description": "Optional. Expression for filtering results.", "type": "string" }, "orderBy": { "type": "string", "description": "Optional. Sort results by a defined order.", "location": "query" }, "pageSize": { "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's The maximum value is 1000; values above 1000 will be coerced to 1000. `next_page_token` to determine if there are more clusters left to be queried.", "format": "int32", "type": "integer", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. The `next_page_token` value returned from a previous [ListTokenAuthUsers] request, if any." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", "required": true, "location": "path", "description": "Required. The parent resource that this token based auth user will be listed for. Format: projects/{project}/locations/{location}/clusters/{cluster}", "type": "string" } }, "id": "redis.projects.locations.clusters.tokenAuthUsers.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/tokenAuthUsers", "parameterOrder": [ "parent" ] }, "get": { "description": "Gets a specific token auth user for a basic auth enabled cluster.", "path": "v1beta1/{+name}", "response": { "$ref": "TokenAuthUser" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "Required. The name of token auth user for a token based auth enabled cluster. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/tokenAuthUsers/[^/]+$", "required": true } }, "id": "redis.projects.locations.clusters.tokenAuthUsers.get", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/tokenAuthUsers/{tokenAuthUsersId}" }, "delete": { "response": { "$ref": "Operation" }, "path": "v1beta1/{+name}", "description": "Deletes a token auth user for a token based auth enabled cluster.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/tokenAuthUsers/{tokenAuthUsersId}", "parameterOrder": [ "name" ], "id": "redis.projects.locations.clusters.tokenAuthUsers.delete", "httpMethod": "DELETE", "parameters": { "requestId": { "location": "query", "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" }, "name": { "type": "string", "description": "Required. The name of the token auth user to delete. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/tokenAuthUsers/[^/]+$", "required": true }, "force": { "type": "boolean", "description": "Optional. If set to true, any child auth tokens of this user will also be deleted. Otherwise, the request will only work if the user has no auth tokens.", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ] } }, "resources": { "authTokens": { "methods": { "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/tokenAuthUsers/{tokenAuthUsersId}/authTokens", "parameterOrder": [ "parent" ], "id": "redis.projects.locations.clusters.tokenAuthUsers.authTokens.list", "httpMethod": "GET", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/tokenAuthUsers/[^/]+$", "required": true, "type": "string", "description": "Required. The parent resource that this auth token will be listed for. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}", "location": "path" }, "filter": { "location": "query", "description": "Optional. Expression for filtering results.", "type": "string" }, "orderBy": { "type": "string", "description": "Optional. Sort results by a defined order.", "location": "query" }, "pageSize": { "location": "query", "type": "integer", "description": "Optional. The maximum number of items to return. The maximum value is 1000; values above 1000 will be coerced to 1000. 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 clusters left to be queried.", "format": "int32" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. The `next_page_token` value returned from a previous [ListTokenAuthUsers] request, if any." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "response": { "$ref": "ListAuthTokensResponse" }, "path": "v1beta1/{+parent}/authTokens", "description": "Lists all the auth tokens for a specific token auth user." }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/tokenAuthUsers/{tokenAuthUsersId}/authTokens/{authTokensId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.clusters.tokenAuthUsers.authTokens.get", "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "Required. The name of auth token for a token based auth enabled cluster. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}/authTokens/{auth_token}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/tokenAuthUsers/[^/]+/authTokens/[^/]+$", "required": true } }, "response": { "$ref": "AuthToken" }, "description": "Gets a specific auth token for a specific token auth user.", "path": "v1beta1/{+name}" }, "delete": { "response": { "$ref": "Operation" }, "path": "v1beta1/{+name}", "description": "Removes a auth token for a user of a token based auth enabled instance.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}/tokenAuthUsers/{tokenAuthUsersId}/authTokens/{authTokensId}", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "description": "Required. The name of the token auth user resource that this auth token will be deleted from. Format: projects/{project}/locations/{location}/clusters/{cluster}/tokenAuthUsers/{token_auth_user}/authTokens/{auth_token}", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+/tokenAuthUsers/[^/]+/authTokens/[^/]+$", "required": true } }, "id": "redis.projects.locations.clusters.tokenAuthUsers.authTokens.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ] } } } } } } }, "operations": { "methods": { "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "response": { "$ref": "ListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.operations.list", "httpMethod": "GET", "parameters": { "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "location": "path", "description": "The name of the operation's parent resource.", "type": "string" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations" }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true, "location": "path", "description": "The name of the operation resource.", "type": "string" } }, "id": "redis.projects.locations.operations.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "response": { "$ref": "Operation" }, "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." }, "delete": { "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`.", "path": "v1beta1/{+name}", "response": { "$ref": "Empty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}" }, "cancel": { "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`.", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "Empty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "POST", "parameters": { "name": { "location": "path", "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true } }, "id": "redis.projects.locations.operations.cancel", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel" } } }, "aclPolicies": { "methods": { "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/aclPolicies", "parameterOrder": [ "parent" ], "id": "redis.projects.locations.aclPolicies.list", "httpMethod": "GET", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The resource name of the cluster location using the form: `projects/{project_id}/locations/{location_id}` where `location_id` refers to a Google Cloud region.", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's `next_page_token` to determine if there are more ACL policies left to be queried. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. The `next_page_token` value returned from a previous `ListAclPolicies` request, if any.", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "response": { "$ref": "ListAclPoliciesResponse" }, "path": "v1beta1/{+parent}/aclPolicies", "description": "Lists all ACL Policies owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated." }, "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "description": "Required. Redis ACL Policy resource name using the form: `projects/{project_id}/locations/{location_id}/aclPolicies/{acl_policy_id}` where `location_id` refers to a GCP region.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/aclPolicies/[^/]+$", "required": true } }, "id": "redis.projects.locations.aclPolicies.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/aclPolicies/{aclPoliciesId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Gets the details of a specific Redis Cluster ACL Policy.", "response": { "$ref": "AclPolicy" } }, "patch": { "request": { "$ref": "AclPolicy" }, "response": { "$ref": "Operation" }, "path": "v1beta1/{+name}", "description": "Updates the ACL policy. The operation applies the updated ACL policy to all of the linked clusters. If Memorystore can apply the policy to all clusters, then the operation returns a SUCCESS status. If Memorystore can't apply the policy to all clusters, then to ensure eventual consistency, Memorystore uses reconciliation to apply the policy to the failed clusters. Completed longrunning.Operation will contain the new ACL Policy object in the response field.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/aclPolicies/{aclPoliciesId}", "parameterOrder": [ "name" ], "id": "redis.projects.locations.aclPolicies.patch", "httpMethod": "PATCH", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/aclPolicies/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Identifier. Full resource path of the ACL policy." }, "updateMask": { "type": "string", "description": "Optional. Mask of fields to be updated. At least one path must be supplied in this field. The elements of the repeated paths field may only include these fields from `AclPolicy`: * `rules`", "format": "google-fieldmask", "location": "query" }, "requestId": { "description": "Optional. Idempotent request UUID.", "type": "string", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ] }, "create": { "id": "redis.projects.locations.aclPolicies.create", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The resource name of the cluster location using the form: `projects/{project_id}/locations/{location_id}` where `location_id` refers to a Google Cloud region.", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "aclPolicyId": { "type": "string", "description": "Required. The logical name of the ACL Policy in the customer project with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the customer project / location", "location": "query" }, "requestId": { "location": "query", "type": "string", "description": "Optional. Idempotent request UUID. ." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/aclPolicies", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/aclPolicies", "description": "Creates an ACL Policy. The creation is executed synchronously and the policy is available for use immediately after the RPC returns.", "request": { "$ref": "AclPolicy" }, "response": { "$ref": "AclPolicy" } }, "delete": { "description": "Deletes a specific Acl Policy. This action will delete the Acl Policy and all the rules associated with it. An ACL policy cannot be deleted if it is attached to a cluster.", "path": "v1beta1/{+name}", "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "DELETE", "parameters": { "requestId": { "type": "string", "description": "Optional. Idempotent request UUID.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/aclPolicies/[^/]+$", "required": true, "type": "string", "description": "Required. Redis ACL Policy resource name using the form: `projects/{project_id}/locations/{location_id}/aclPolicies/{acl_policy_id}` where `location_id` refers to a GCP region.", "location": "path" }, "etag": { "location": "query", "type": "string", "description": "Optional. Etag of the ACL policy. If this is different from the server's etag, the request will fail with an ABORTED error." } }, "id": "redis.projects.locations.aclPolicies.delete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/aclPolicies/{aclPoliciesId}" } } }, "instances": { "methods": { "list": { "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-only", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.instances.list", "httpMethod": "GET", "parameters": { "parent": { "location": "path", "description": "Required. The resource name of the instance location using the form: `projects/{project_id}/locations/{location_id}` where `location_id` refers to a GCP region.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "pageSize": { "location": "query", "description": "The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's `next_page_token` to determine if there are more instances left to be queried.", "format": "int32", "type": "integer" }, "pageToken": { "type": "string", "description": "The `next_page_token` value returned from a previous ListInstances request, if any.", "location": "query" } }, "response": { "$ref": "ListInstancesResponse" }, "description": "Lists all Redis instances owned by a project in either the specified location (region) or all locations. The location should have the following format: * `projects/{project_id}/locations/{location_id}` If `location_id` is specified as `-` (wildcard), then all regions available to the project are queried, and the results are aggregated.", "path": "v1beta1/{+parent}/instances" }, "get": { "response": { "$ref": "Instance" }, "description": "Gets the details of a specific Redis instance.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-only", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.instances.get", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "location": "path", "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region.", "type": "string" } } }, "patch": { "description": "Updates the metadata and configuration of a specific Redis instance. Completed longrunning.Operation will contain the new instance object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.", "path": "v1beta1/{+name}", "request": { "$ref": "Instance" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.instances.patch", "httpMethod": "PATCH", "parameters": { "updateMask": { "location": "query", "type": "string", "description": "Required. Mask of fields to update. At least one path must be supplied in this field. The elements of the repeated paths field may only include these fields from Instance: * `displayName` * `labels` * `memorySizeGb` * `redisConfig` * `replica_count`", "format": "google-fieldmask" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Required. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` Note: Redis instances are managed and addressed at regional level so location_id here refers to a GCP region; however, users may choose which specific zone (or collection of zones for cross-zone instances) an instance should be provisioned in. Refer to location_id and alternative_location_id fields for more details." } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}" }, "failover": { "description": "Initiates a failover of the primary node to current replica node for a specific STANDARD tier Cloud Memorystore for Redis instance.", "path": "v1beta1/{+name}:failover", "request": { "$ref": "FailoverInstanceRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "id": "redis.projects.locations.instances.failover", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:failover" }, "rescheduleMaintenance": { "description": "Reschedule maintenance for a given instance in a given project and location.", "path": "v1beta1/{+name}:rescheduleMaintenance", "request": { "$ref": "RescheduleMaintenanceRequest" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "type": "string", "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region.", "location": "path" } }, "id": "redis.projects.locations.instances.rescheduleMaintenance", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:rescheduleMaintenance" }, "export": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:export", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "POST", "parameters": { "name": { "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region.", "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true } }, "id": "redis.projects.locations.instances.export", "request": { "$ref": "ExportInstanceRequest" }, "response": { "$ref": "Operation" }, "description": "Export Redis instance data into a Redis RDB format file in Cloud Storage. Redis will continue serving during this operation. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.", "path": "v1beta1/{+name}:export" }, "create": { "id": "redis.projects.locations.instances.create", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The resource name of the instance location using the form: `projects/{project_id}/locations/{location_id}` where `location_id` refers to a GCP region.", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "instanceId": { "location": "query", "type": "string", "description": "Required. The logical name of the Redis instance in the customer project with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-40 characters. * Must end with a number or a letter. * Must be unique within the customer project / location" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/instances", "description": "Creates a Redis instance based on the specified tier and memory size. By default, the instance is accessible from the project's [default network](https://cloud.google.com/vpc/docs/vpc). The creation is executed asynchronously and callers may check the returned operation to track its progress. Once the operation is completed the Redis instance will be fully functional. The completed longrunning.Operation will contain the new instance object in the response field. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation.", "request": { "$ref": "Instance" }, "response": { "$ref": "Operation" } }, "getAuthString": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/authString", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "type": "string", "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region.", "location": "path" } }, "id": "redis.projects.locations.instances.getAuthString", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-only", "https://www.googleapis.com/auth/redis.read-write" ], "response": { "$ref": "InstanceAuthString" }, "path": "v1beta1/{+name}/authString", "description": "Gets the AUTH string for a Redis instance. If AUTH is not enabled for the instance the response will be empty. This information is not included in the details returned to GetInstance." }, "upgrade": { "request": { "$ref": "UpgradeInstanceRequest" }, "response": { "$ref": "Operation" }, "description": "Upgrades Redis instance to the newer Redis version specified in the request.", "path": "v1beta1/{+name}:upgrade", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:upgrade", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region.", "type": "string", "location": "path" } }, "id": "redis.projects.locations.instances.upgrade" }, "delete": { "id": "redis.projects.locations.instances.delete", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Deletes a specific Redis instance. Instance stops serving and data is deleted.", "response": { "$ref": "Operation" } }, "import": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:import", "parameterOrder": [ "name" ], "id": "redis.projects.locations.instances.import", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "location": "path", "description": "Required. Redis instance resource name using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` where `location_id` refers to a GCP region.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/redis.read-write" ], "request": { "$ref": "ImportInstanceRequest" }, "response": { "$ref": "Operation" }, "path": "v1beta1/{+name}:import", "description": "Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. Redis may stop serving during this operation. Instance state will be IMPORTING for entire operation. When complete, the instance will contain only data from the imported file. The returned operation is automatically deleted after a few hours, so there is no need to call DeleteOperation." } } } } } } } }, "rootUrl": "https://redis.googleapis.com/", "version": "v1beta1", "baseUrl": "https://redis.googleapis.com/", "servicePath": "", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "parameters": { "uploadType": { "location": "query", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "type": "string" }, "prettyPrint": { "location": "query", "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true" }, "quotaUser": { "location": "query", "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters." }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." }, "alt": { "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query", "enum": [ "json", "media", "proto" ], "type": "string", "description": "Data format for response.", "default": "json" }, "fields": { "location": "query", "description": "Selector specifying which fields to include in a partial response.", "type": "string" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "$.xgafv": { "enumDescriptions": [ "v1 error format", "v2 error format" ], "description": "V1 error format.", "type": "string", "enum": [ "1", "2" ], "location": "query" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "access_token": { "location": "query", "description": "OAuth access token.", "type": "string" }, "key": { "location": "query", "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } }, "ownerName": "Google" }