6581 lines
329 KiB
TypeScript
6581 lines
329 KiB
TypeScript
import { OAuth2Client, JWT, Compute, UserRefreshClient, BaseExternalAccountClient, GaxiosResponseWithHTTP2, GoogleConfigurable, MethodOptions, StreamMethodOptions, GlobalOptions, GoogleAuth, BodyResponseCallback, APIRequestContext } from 'googleapis-common';
|
|
import { Readable } from 'stream';
|
|
export declare namespace alloydb_v1 {
|
|
export interface Options extends GlobalOptions {
|
|
version: 'v1';
|
|
}
|
|
interface StandardParameters {
|
|
/**
|
|
* Auth client or API Key for the request
|
|
*/
|
|
auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient | BaseExternalAccountClient | GoogleAuth;
|
|
/**
|
|
* V1 error format.
|
|
*/
|
|
'$.xgafv'?: string;
|
|
/**
|
|
* OAuth access token.
|
|
*/
|
|
access_token?: string;
|
|
/**
|
|
* Data format for response.
|
|
*/
|
|
alt?: string;
|
|
/**
|
|
* JSONP
|
|
*/
|
|
callback?: string;
|
|
/**
|
|
* Selector specifying which fields to include in a partial response.
|
|
*/
|
|
fields?: string;
|
|
/**
|
|
* 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.
|
|
*/
|
|
key?: string;
|
|
/**
|
|
* OAuth 2.0 token for the current user.
|
|
*/
|
|
oauth_token?: string;
|
|
/**
|
|
* Returns response with indentations and line breaks.
|
|
*/
|
|
prettyPrint?: boolean;
|
|
/**
|
|
* 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.
|
|
*/
|
|
quotaUser?: string;
|
|
/**
|
|
* Legacy upload protocol for media (e.g. "media", "multipart").
|
|
*/
|
|
uploadType?: string;
|
|
/**
|
|
* Upload protocol for media (e.g. "raw", "multipart").
|
|
*/
|
|
upload_protocol?: string;
|
|
}
|
|
/**
|
|
* AlloyDB API
|
|
*
|
|
* AlloyDB for PostgreSQL is an open source-compatible database service that provides a powerful option for migrating, modernizing, or building commercial-grade applications. It offers full compatibility with standard PostgreSQL, and is more than 4x faster for transactional workloads and up to 100x faster for analytical queries than standard PostgreSQL in our performance tests. AlloyDB for PostgreSQL offers a 99.99 percent availability SLA inclusive of maintenance. AlloyDB is optimized for the most demanding use cases, allowing you to build new applications that require high transaction throughput, large database sizes, or multiple read resources; scale existing PostgreSQL workloads with no application changes; and modernize legacy proprietary databases.
|
|
*
|
|
* @example
|
|
* ```js
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
* ```
|
|
*/
|
|
export class Alloydb {
|
|
context: APIRequestContext;
|
|
projects: Resource$Projects;
|
|
constructor(options: GlobalOptions, google?: GoogleConfigurable);
|
|
}
|
|
/**
|
|
* AuthorizedNetwork contains metadata for an authorized network.
|
|
*/
|
|
export interface Schema$AuthorizedNetwork {
|
|
/**
|
|
* CIDR range for one authorzied network of the instance.
|
|
*/
|
|
cidrRange?: string | null;
|
|
}
|
|
/**
|
|
* Message describing the user-specified automated backup policy. All fields in the automated backup policy are optional. Defaults for each field are provided if they are not set.
|
|
*/
|
|
export interface Schema$AutomatedBackupPolicy {
|
|
/**
|
|
* The length of the time window during which a backup can be taken. If a backup does not succeed within this time window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it defaults to 1 hour.
|
|
*/
|
|
backupWindow?: string | null;
|
|
/**
|
|
* Whether automated automated backups are enabled. If not set, defaults to true.
|
|
*/
|
|
enabled?: boolean | null;
|
|
/**
|
|
* Optional. The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will use the cluster's encryption config.
|
|
*/
|
|
encryptionConfig?: Schema$EncryptionConfig;
|
|
/**
|
|
* Labels to apply to backups created using this configuration.
|
|
*/
|
|
labels?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* The location where the backup will be stored. Currently, the only supported option is to store the backup in the same region as the cluster. If empty, defaults to the region of the cluster.
|
|
*/
|
|
location?: string | null;
|
|
/**
|
|
* Quantity-based Backup retention policy to retain recent backups.
|
|
*/
|
|
quantityBasedRetention?: Schema$QuantityBasedRetention;
|
|
/**
|
|
* Time-based Backup retention policy.
|
|
*/
|
|
timeBasedRetention?: Schema$TimeBasedRetention;
|
|
/**
|
|
* Weekly schedule for the Backup.
|
|
*/
|
|
weeklySchedule?: Schema$WeeklySchedule;
|
|
}
|
|
/**
|
|
* Message describing Backup object
|
|
*/
|
|
export interface Schema$Backup {
|
|
/**
|
|
* Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128
|
|
*/
|
|
annotations?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Required. The full resource name of the backup source cluster (e.g., projects/{project\}/locations/{region\}/clusters/{cluster_id\}).
|
|
*/
|
|
clusterName?: string | null;
|
|
/**
|
|
* Output only. The system-generated UID of the cluster which was used to create this resource.
|
|
*/
|
|
clusterUid?: string | null;
|
|
/**
|
|
* Output only. Timestamp when the resource finished being created.
|
|
*/
|
|
createCompletionTime?: string | null;
|
|
/**
|
|
* Output only. Create time stamp
|
|
*/
|
|
createTime?: string | null;
|
|
/**
|
|
* Output only. The database engine major version of the cluster this backup was created from. Any restored cluster created from this backup will have the same database version.
|
|
*/
|
|
databaseVersion?: string | null;
|
|
/**
|
|
* Output only. Delete time stamp
|
|
*/
|
|
deleteTime?: string | null;
|
|
/**
|
|
* User-provided description of the backup.
|
|
*/
|
|
description?: string | null;
|
|
/**
|
|
* User-settable and human-readable display name for the Backup.
|
|
*/
|
|
displayName?: string | null;
|
|
/**
|
|
* Optional. The encryption config can be specified to encrypt the backup with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data.
|
|
*/
|
|
encryptionConfig?: Schema$EncryptionConfig;
|
|
/**
|
|
* Output only. The encryption information for the backup.
|
|
*/
|
|
encryptionInfo?: Schema$EncryptionInfo;
|
|
/**
|
|
* For Resource freshness validation (https://google.aip.dev/154)
|
|
*/
|
|
etag?: string | null;
|
|
/**
|
|
* Output only. The QuantityBasedExpiry of the backup, specified by the backup's retention policy. Once the expiry quantity is over retention, the backup is eligible to be garbage collected.
|
|
*/
|
|
expiryQuantity?: Schema$QuantityBasedExpiry;
|
|
/**
|
|
* Output only. The time at which after the backup is eligible to be garbage collected. It is the duration specified by the backup's retention policy, added to the backup's create_time.
|
|
*/
|
|
expiryTime?: string | null;
|
|
/**
|
|
* Labels as key value pairs
|
|
*/
|
|
labels?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Output only. The name of the backup resource with the format: * projects/{project\}/locations/{region\}/backups/{backup_id\} where the cluster and backup ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the backup resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Output only. Reconciling (https://google.aip.dev/128#reconciliation), if true, indicates that the service is actively updating the resource. This can happen due to user-triggered updates or system actions like failover or maintenance.
|
|
*/
|
|
reconciling?: boolean | null;
|
|
/**
|
|
* Output only. Reserved for future use.
|
|
*/
|
|
satisfiesPzs?: boolean | null;
|
|
/**
|
|
* Output only. The size of the backup in bytes.
|
|
*/
|
|
sizeBytes?: string | null;
|
|
/**
|
|
* Output only. The current state of the backup.
|
|
*/
|
|
state?: string | null;
|
|
/**
|
|
* Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: ``` "123/environment": "production", "123/costCenter": "marketing" ```
|
|
*/
|
|
tags?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* The backup type, which suggests the trigger for the backup.
|
|
*/
|
|
type?: string | null;
|
|
/**
|
|
* Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.
|
|
*/
|
|
uid?: string | null;
|
|
/**
|
|
* Output only. Update time stamp Users should not infer any meaning from this field. Its value is generally unrelated to the timing of the backup creation operation.
|
|
*/
|
|
updateTime?: string | null;
|
|
}
|
|
/**
|
|
* Message describing a BackupDrBackupSource.
|
|
*/
|
|
export interface Schema$BackupDrBackupSource {
|
|
/**
|
|
* Required. The name of the backup resource with the format: * projects/{project\}/locations/{location\}/backupVaults/{backupvault_id\}/dataSources/{datasource_id\}/backups/{backup_id\}
|
|
*/
|
|
backup?: string | null;
|
|
}
|
|
/**
|
|
* Information about a single window when BackupDR was enabled for this cluster.
|
|
*/
|
|
export interface Schema$BackupDrEnabledWindow {
|
|
/**
|
|
* Whether automated backup was previously enabled prior to enabling BackupDR protection for this cluster.
|
|
*/
|
|
automatedBackupPreviouslyEnabled?: boolean | null;
|
|
/**
|
|
* The BackupPlanAssociation resource that was used to enable BackupDR protection for this cluster.
|
|
*/
|
|
backupPlanAssociation?: string | null;
|
|
/**
|
|
* Whether continuous backup was previously enabled prior to enabling BackupDR protection for this cluster.
|
|
*/
|
|
continuousBackupPreviouslyEnabled?: boolean | null;
|
|
/**
|
|
* The time when continuous backup was previously enabled prior to enabling BackupDR protection for this cluster.
|
|
*/
|
|
continuousBackupPreviouslyEnabledTime?: string | null;
|
|
/**
|
|
* The retention set for the continuous backup that was previously enabled prior to enabling BackupDR protection for this cluster.
|
|
*/
|
|
continuousBackupPreviousRecoveryWindowDays?: number | null;
|
|
/**
|
|
* The DataSource resource that represents the cluster in BackupDR.
|
|
*/
|
|
dataSource?: string | null;
|
|
/**
|
|
* Time when the BackupDR protection for this cluster was disabled. This field will be empty if this BackupDR window is the `current_window`.
|
|
*/
|
|
disabledTime?: string | null;
|
|
/**
|
|
* Time when the BackupDR protection for this cluster was enabled.
|
|
*/
|
|
enabledTime?: string | null;
|
|
/**
|
|
* The retention period for logs generated by BackupDR for this cluster.
|
|
*/
|
|
logRetentionPeriod?: string | null;
|
|
}
|
|
/**
|
|
* Information about BackupDR protection for this cluster.
|
|
*/
|
|
export interface Schema$BackupDrInfo {
|
|
/**
|
|
* The current BackupDR configuration for this cluster. If BackupDR protection is not enabled for this cluster, this field will be empty.
|
|
*/
|
|
currentWindow?: Schema$BackupDrEnabledWindow;
|
|
/**
|
|
* Windows during which BackupDR was enabled for this cluster, along with associated configuration for that window. These are used to determine points-in-time for which restores can be performed. The windows are ordered with the most recent window last. Windows are mutally exclusive. Windows which closed more than 1 year ago will be removed from this list.
|
|
*/
|
|
previousWindows?: Schema$BackupDrEnabledWindow[];
|
|
}
|
|
/**
|
|
* Message describing a BackupDrPitrSource.
|
|
*/
|
|
export interface Schema$BackupDrPitrSource {
|
|
/**
|
|
* Required. The name of the backup resource with the format: * projects/{project\}/locations/{location\}/backupVaults/{backupvault_id\}/dataSources/{datasource_id\}
|
|
*/
|
|
dataSource?: string | null;
|
|
/**
|
|
* Required. The point in time to restore to.
|
|
*/
|
|
pointInTime?: string | null;
|
|
}
|
|
/**
|
|
* Message describing a BackupSource.
|
|
*/
|
|
export interface Schema$BackupSource {
|
|
/**
|
|
* Required. The name of the backup resource with the format: * projects/{project\}/locations/{region\}/backups/{backup_id\}
|
|
*/
|
|
backupName?: string | null;
|
|
/**
|
|
* Output only. The system-generated UID of the backup which was used to create this resource. The UID is generated when the backup is created, and it is retained until the backup is deleted.
|
|
*/
|
|
backupUid?: string | null;
|
|
}
|
|
/**
|
|
* The request message for Operations.CancelOperation.
|
|
*/
|
|
export interface Schema$CancelOperationRequest {
|
|
}
|
|
/**
|
|
* Client connection configuration
|
|
*/
|
|
export interface Schema$ClientConnectionConfig {
|
|
/**
|
|
* Optional. Configuration to enforce connectors only (ex: AuthProxy) connections to the database.
|
|
*/
|
|
requireConnectors?: boolean | null;
|
|
/**
|
|
* Optional. SSL configuration option for this instance.
|
|
*/
|
|
sslConfig?: Schema$SslConfig;
|
|
}
|
|
/**
|
|
* Operation metadata returned by the CLH during resource state reconciliation.
|
|
*/
|
|
export interface Schema$CloudControl2SharedOperationsReconciliationOperationMetadata {
|
|
/**
|
|
* DEPRECATED. Use exclusive_action instead.
|
|
*/
|
|
deleteResource?: boolean | null;
|
|
/**
|
|
* Excluisive action returned by the CLH.
|
|
*/
|
|
exclusiveAction?: string | null;
|
|
}
|
|
/**
|
|
* The source CloudSQL backup resource.
|
|
*/
|
|
export interface Schema$CloudSQLBackupRunSource {
|
|
/**
|
|
* Required. The CloudSQL backup run ID.
|
|
*/
|
|
backupRunId?: string | null;
|
|
/**
|
|
* Required. The CloudSQL instance ID.
|
|
*/
|
|
instanceId?: string | null;
|
|
/**
|
|
* The project ID of the source CloudSQL instance. This should be the same as the AlloyDB cluster's project.
|
|
*/
|
|
project?: string | null;
|
|
}
|
|
/**
|
|
* A cluster is a collection of regional AlloyDB resources. It can include a primary instance and one or more read pool instances. All cluster resources share a storage layer, which scales as needed.
|
|
*/
|
|
export interface Schema$Cluster {
|
|
/**
|
|
* Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128
|
|
*/
|
|
annotations?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* The automated backup policy for this cluster. If no policy is provided then the default policy will be used. If backups are supported for the cluster, the default policy takes one backup a day, has a backup window of 1 hour, and retains backups for 14 days. For more information on the defaults, consult the documentation for the message type.
|
|
*/
|
|
automatedBackupPolicy?: Schema$AutomatedBackupPolicy;
|
|
/**
|
|
* Output only. Cluster created from a BackupDR backup.
|
|
*/
|
|
backupdrBackupSource?: Schema$BackupDrBackupSource;
|
|
/**
|
|
* Output only. Output only information about BackupDR protection for this cluster.
|
|
*/
|
|
backupdrInfo?: Schema$BackupDrInfo;
|
|
/**
|
|
* Output only. Cluster created from backup.
|
|
*/
|
|
backupSource?: Schema$BackupSource;
|
|
/**
|
|
* Output only. Cluster created from CloudSQL snapshot.
|
|
*/
|
|
cloudsqlBackupRunSource?: Schema$CloudSQLBackupRunSource;
|
|
/**
|
|
* Output only. The type of the cluster. This is an output-only field and it's populated at the Cluster creation time or the Cluster promotion time. The cluster type is determined by which RPC was used to create the cluster (i.e. `CreateCluster` vs. `CreateSecondaryCluster`
|
|
*/
|
|
clusterType?: string | null;
|
|
/**
|
|
* Optional. Continuous backup configuration for this cluster.
|
|
*/
|
|
continuousBackupConfig?: Schema$ContinuousBackupConfig;
|
|
/**
|
|
* Output only. Continuous backup properties for this cluster.
|
|
*/
|
|
continuousBackupInfo?: Schema$ContinuousBackupInfo;
|
|
/**
|
|
* Output only. Create time stamp
|
|
*/
|
|
createTime?: string | null;
|
|
/**
|
|
* Optional. The database engine major version. This is an optional field and it is populated at the Cluster creation time. If a database version is not supplied at cluster creation time, then a default database version will be used.
|
|
*/
|
|
databaseVersion?: string | null;
|
|
/**
|
|
* Optional. Configuration for Dataplex integration.
|
|
*/
|
|
dataplexConfig?: Schema$DataplexConfig;
|
|
/**
|
|
* Output only. Delete time stamp
|
|
*/
|
|
deleteTime?: string | null;
|
|
/**
|
|
* User-settable and human-readable display name for the Cluster.
|
|
*/
|
|
displayName?: string | null;
|
|
/**
|
|
* Optional. The encryption config can be specified to encrypt the data disks and other persistent data resources of a cluster with a customer-managed encryption key (CMEK). When this field is not specified, the cluster will then use default encryption scheme to protect the user data.
|
|
*/
|
|
encryptionConfig?: Schema$EncryptionConfig;
|
|
/**
|
|
* Output only. The encryption information for the cluster.
|
|
*/
|
|
encryptionInfo?: Schema$EncryptionInfo;
|
|
/**
|
|
* For Resource freshness validation (https://google.aip.dev/154)
|
|
*/
|
|
etag?: string | null;
|
|
/**
|
|
* Input only. Initial user to setup during cluster creation. Required. If used in `RestoreCluster` this is ignored.
|
|
*/
|
|
initialUser?: Schema$UserPassword;
|
|
/**
|
|
* Labels as key value pairs
|
|
*/
|
|
labels?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Output only. The maintenance schedule for the cluster, generated for a specific rollout if a maintenance window is set.
|
|
*/
|
|
maintenanceSchedule?: Schema$MaintenanceSchedule;
|
|
/**
|
|
* Optional. The maintenance update policy determines when to allow or deny updates.
|
|
*/
|
|
maintenanceUpdatePolicy?: Schema$MaintenanceUpdatePolicy;
|
|
/**
|
|
* Input only. Policy to use to automatically select the maintenance version to which to update the cluster's instances.
|
|
*/
|
|
maintenanceVersionSelectionPolicy?: string | null;
|
|
/**
|
|
* Output only. Cluster created via DMS migration.
|
|
*/
|
|
migrationSource?: Schema$MigrationSource;
|
|
/**
|
|
* Output only. The name of the cluster resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\} where the cluster ID segment should satisfy the regex expression `[a-z0-9-]+`. For more details see https://google.aip.dev/122. The prefix of the cluster resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Required. The resource link for the VPC network in which cluster resources are created and from which they are accessible via Private IP. The network must belong to the same project as the cluster. It is specified in the form: `projects/{project\}/global/networks/{network_id\}`. This is required to create a cluster. Deprecated, use network_config.network instead.
|
|
*/
|
|
network?: string | null;
|
|
networkConfig?: Schema$NetworkConfig;
|
|
/**
|
|
* Output only. Cross Region replication config specific to PRIMARY cluster.
|
|
*/
|
|
primaryConfig?: Schema$PrimaryConfig;
|
|
/**
|
|
* Optional. The configuration for Private Service Connect (PSC) for the cluster.
|
|
*/
|
|
pscConfig?: Schema$PscConfig;
|
|
/**
|
|
* Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Cluster does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.
|
|
*/
|
|
reconciling?: boolean | null;
|
|
/**
|
|
* Output only. Reserved for future use.
|
|
*/
|
|
satisfiesPzs?: boolean | null;
|
|
/**
|
|
* Cross Region replication config specific to SECONDARY cluster.
|
|
*/
|
|
secondaryConfig?: Schema$SecondaryConfig;
|
|
/**
|
|
* SSL configuration for this AlloyDB cluster.
|
|
*/
|
|
sslConfig?: Schema$SslConfig;
|
|
/**
|
|
* Output only. The current serving state of the cluster.
|
|
*/
|
|
state?: string | null;
|
|
/**
|
|
* Optional. Subscription type of the cluster.
|
|
*/
|
|
subscriptionType?: string | null;
|
|
/**
|
|
* Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: ``` "123/environment": "production", "123/costCenter": "marketing" ```
|
|
*/
|
|
tags?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Output only. Metadata for free trial clusters
|
|
*/
|
|
trialMetadata?: Schema$TrialMetadata;
|
|
/**
|
|
* Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.
|
|
*/
|
|
uid?: string | null;
|
|
/**
|
|
* Output only. Update time stamp
|
|
*/
|
|
updateTime?: string | null;
|
|
}
|
|
/**
|
|
* Upgrade details of a cluster. This cluster can be primary or secondary.
|
|
*/
|
|
export interface Schema$ClusterUpgradeDetails {
|
|
/**
|
|
* Cluster type which can either be primary or secondary.
|
|
*/
|
|
clusterType?: string | null;
|
|
/**
|
|
* Database version of the cluster after the upgrade operation. This will be the target version if the upgrade was successful otherwise it remains the same as that before the upgrade operation.
|
|
*/
|
|
databaseVersion?: string | null;
|
|
/**
|
|
* Upgrade details of the instances directly associated with this cluster.
|
|
*/
|
|
instanceUpgradeDetails?: Schema$InstanceUpgradeDetails[];
|
|
/**
|
|
* Normalized name of the cluster
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Array containing stage info associated with this cluster.
|
|
*/
|
|
stageInfo?: Schema$StageInfo[];
|
|
/**
|
|
* Upgrade status of the cluster.
|
|
*/
|
|
upgradeStatus?: string | null;
|
|
}
|
|
/**
|
|
* ConnectionInfo singleton resource. https://google.aip.dev/156
|
|
*/
|
|
export interface Schema$ConnectionInfo {
|
|
/**
|
|
* Output only. The unique ID of the Instance.
|
|
*/
|
|
instanceUid?: string | null;
|
|
/**
|
|
* Output only. The private network IP address for the Instance. This is the default IP for the instance and is always created (even if enable_public_ip is set). This is the connection endpoint for an end-user application.
|
|
*/
|
|
ipAddress?: string | null;
|
|
/**
|
|
* The name of the ConnectionInfo singleton resource, e.g.: projects/{project\}/locations/{location\}/clusters/x/instances/x/connectionInfo This field currently has no semantic meaning.
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application.
|
|
*/
|
|
publicIpAddress?: string | null;
|
|
}
|
|
/**
|
|
* Configuration for Managed Connection Pool (MCP).
|
|
*/
|
|
export interface Schema$ConnectionPoolConfig {
|
|
/**
|
|
* Optional. Whether to enable Managed Connection Pool (MCP).
|
|
*/
|
|
enabled?: boolean | null;
|
|
/**
|
|
* Optional. Connection Pool flags, as a list of "key": "value" pairs.
|
|
*/
|
|
flags?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Output only. The number of running poolers per instance.
|
|
*/
|
|
poolerCount?: number | null;
|
|
}
|
|
/**
|
|
* ContinuousBackupConfig describes the continuous backups recovery configurations of a cluster.
|
|
*/
|
|
export interface Schema$ContinuousBackupConfig {
|
|
/**
|
|
* Whether ContinuousBackup is enabled.
|
|
*/
|
|
enabled?: boolean | null;
|
|
/**
|
|
* The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will use the cluster's encryption config.
|
|
*/
|
|
encryptionConfig?: Schema$EncryptionConfig;
|
|
/**
|
|
* The number of days that are eligible to restore from using PITR. To support the entire recovery window, backups and logs are retained for one day more than the recovery window. If not set, defaults to 14 days.
|
|
*/
|
|
recoveryWindowDays?: number | null;
|
|
}
|
|
/**
|
|
* ContinuousBackupInfo describes the continuous backup properties of a cluster.
|
|
*/
|
|
export interface Schema$ContinuousBackupInfo {
|
|
/**
|
|
* Output only. The earliest restorable time that can be restored to. If continuous backups and recovery was recently enabled, the earliest restorable time is the creation time of the earliest eligible backup within this cluster's continuous backup recovery window. After a cluster has had continuous backups enabled for the duration of its recovery window, the earliest restorable time becomes "now minus the recovery window". For example, assuming a point in time recovery is attempted at 04/16/2025 3:23:00PM with a 14d recovery window, the earliest restorable time would be 04/02/2025 3:23:00PM. This field is only visible if the CLUSTER_VIEW_CONTINUOUS_BACKUP cluster view is provided.
|
|
*/
|
|
earliestRestorableTime?: string | null;
|
|
/**
|
|
* Output only. When ContinuousBackup was most recently enabled. Set to null if ContinuousBackup is not enabled.
|
|
*/
|
|
enabledTime?: string | null;
|
|
/**
|
|
* Output only. The encryption information for the WALs and backups required for ContinuousBackup.
|
|
*/
|
|
encryptionInfo?: Schema$EncryptionInfo;
|
|
/**
|
|
* Output only. Days of the week on which a continuous backup is taken.
|
|
*/
|
|
schedule?: string[] | null;
|
|
}
|
|
/**
|
|
* Message describing a ContinuousBackupSource.
|
|
*/
|
|
export interface Schema$ContinuousBackupSource {
|
|
/**
|
|
* Required. The source cluster from which to restore. This cluster must have continuous backup enabled for this operation to succeed. For the required format, see the comment on the Cluster.name field.
|
|
*/
|
|
cluster?: string | null;
|
|
/**
|
|
* Required. The point in time to restore to.
|
|
*/
|
|
pointInTime?: string | null;
|
|
}
|
|
/**
|
|
* Options for exporting data in CSV format.
|
|
*/
|
|
export interface Schema$CsvExportOptions {
|
|
/**
|
|
* Optional. Specifies the character that should appear before a data character that needs to be escaped. The default is the same as quote character. The value of this argument has to be a character in Hex ASCII Code.
|
|
*/
|
|
escapeCharacter?: string | null;
|
|
/**
|
|
* Optional. Specifies the character that separates columns within each row (line) of the file. The default is comma. The value of this argument has to be a character in Hex ASCII Code.
|
|
*/
|
|
fieldDelimiter?: string | null;
|
|
/**
|
|
* Optional. Specifies the quoting character to be used when a data value is quoted. The default is double-quote. The value of this argument has to be a character in Hex ASCII Code.
|
|
*/
|
|
quoteCharacter?: string | null;
|
|
/**
|
|
* Required. The SELECT query used to extract the data.
|
|
*/
|
|
selectQuery?: string | null;
|
|
}
|
|
/**
|
|
* Options for importing data in CSV format.
|
|
*/
|
|
export interface Schema$CsvImportOptions {
|
|
/**
|
|
* Optional. The columns to which CSV data is imported. If not specified, all columns of the database table are loaded with CSV data.
|
|
*/
|
|
columns?: string[] | null;
|
|
/**
|
|
* Optional. Specifies the character that should appear before a data character that needs to be escaped. The default is same as quote character. The value of this argument has to be a character in Hex ASCII Code.
|
|
*/
|
|
escapeCharacter?: string | null;
|
|
/**
|
|
* Optional. Specifies the character that separates columns within each row (line) of the file. The default is comma. The value of this argument has to be a character in Hex ASCII Code.
|
|
*/
|
|
fieldDelimiter?: string | null;
|
|
/**
|
|
* Optional. Specifies the quoting character to be used when a data value is quoted. The default is double-quote. The value of this argument has to be a character in Hex ASCII Code.
|
|
*/
|
|
quoteCharacter?: string | null;
|
|
/**
|
|
* Required. The database table to import CSV file into.
|
|
*/
|
|
table?: string | null;
|
|
}
|
|
/**
|
|
* Configuration for Dataplex integration.
|
|
*/
|
|
export interface Schema$DataplexConfig {
|
|
/**
|
|
* Dataplex is enabled by default for resources such as clusters and instances. This flag controls the integration of AlloyDB PG resources (like databases, schemas, and tables) with Dataplex."
|
|
*/
|
|
enabled?: boolean | null;
|
|
}
|
|
/**
|
|
* DenyMaintenancePeriod definition. Excepting emergencies, maintenance will not be scheduled to start within this deny period. The start_date must be less than the end_date.
|
|
*/
|
|
export interface Schema$DenyMaintenancePeriod {
|
|
/**
|
|
* Deny period end date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring
|
|
*/
|
|
endDate?: Schema$GoogleTypeDate;
|
|
/**
|
|
* Deny period start date. This can be: * A full date, with non-zero year, month and day values OR * A month and day value, with a zero year for recurring
|
|
*/
|
|
startDate?: Schema$GoogleTypeDate;
|
|
/**
|
|
* Time in UTC when the deny period starts on start_date and ends on end_date. This can be: * Full time OR * All zeros for 00:00:00 UTC
|
|
*/
|
|
time?: Schema$GoogleTypeTimeOfDay;
|
|
}
|
|
/**
|
|
* 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); \}
|
|
*/
|
|
export interface Schema$Empty {
|
|
}
|
|
/**
|
|
* EncryptionConfig describes the encryption config of a cluster or a backup that is encrypted with a CMEK (customer-managed encryption key).
|
|
*/
|
|
export interface Schema$EncryptionConfig {
|
|
/**
|
|
* The fully-qualified resource name of the KMS key. Each Cloud KMS key is regionalized and has the following format: projects/[PROJECT]/locations/[REGION]/keyRings/[RING]/cryptoKeys/[KEY_NAME]
|
|
*/
|
|
kmsKeyName?: string | null;
|
|
}
|
|
/**
|
|
* EncryptionInfo describes the encryption information of a cluster or a backup.
|
|
*/
|
|
export interface Schema$EncryptionInfo {
|
|
/**
|
|
* Output only. Type of encryption.
|
|
*/
|
|
encryptionType?: string | null;
|
|
/**
|
|
* Output only. Cloud KMS key versions that are being used to protect the database or the backup.
|
|
*/
|
|
kmsKeyVersions?: string[] | null;
|
|
}
|
|
/**
|
|
* Export cluster request.
|
|
*/
|
|
export interface Schema$ExportClusterRequest {
|
|
/**
|
|
* Options for exporting data in CSV format. Required field to be set for CSV file type.
|
|
*/
|
|
csvExportOptions?: Schema$CsvExportOptions;
|
|
/**
|
|
* Required. Name of the database where the export command will be executed. Note - Value provided should be the same as expected from `SELECT current_database();` and NOT as a resource reference.
|
|
*/
|
|
database?: string | null;
|
|
/**
|
|
* Required. Option to export data to cloud storage.
|
|
*/
|
|
gcsDestination?: Schema$GcsDestination;
|
|
/**
|
|
* Options for exporting data in SQL format. Required field to be set for SQL file type.
|
|
*/
|
|
sqlExportOptions?: Schema$SqlExportOptions;
|
|
}
|
|
/**
|
|
* Response of export cluster rpc.
|
|
*/
|
|
export interface Schema$ExportClusterResponse {
|
|
/**
|
|
* Required. Option to export data to cloud storage.
|
|
*/
|
|
gcsDestination?: Schema$GcsDestination;
|
|
}
|
|
/**
|
|
* Message for triggering failover on an Instance
|
|
*/
|
|
export interface Schema$FailoverInstanceRequest {
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string | null;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean | null;
|
|
}
|
|
/**
|
|
* Destination for Export. Export will be done to cloud storage.
|
|
*/
|
|
export interface Schema$GcsDestination {
|
|
/**
|
|
* Required. The path to the file in Google Cloud Storage where the export will be stored. The URI is in the form `gs://bucketName/fileName`.
|
|
*/
|
|
uri?: string | null;
|
|
}
|
|
/**
|
|
* The response message for Locations.ListLocations.
|
|
*/
|
|
export interface Schema$GoogleCloudLocationListLocationsResponse {
|
|
/**
|
|
* A list of locations that matches the specified filter in the request.
|
|
*/
|
|
locations?: Schema$GoogleCloudLocationLocation[];
|
|
/**
|
|
* The standard List next-page token.
|
|
*/
|
|
nextPageToken?: string | null;
|
|
}
|
|
/**
|
|
* A resource that represents a Google Cloud location.
|
|
*/
|
|
export interface Schema$GoogleCloudLocationLocation {
|
|
/**
|
|
* The friendly name for this location, typically a nearby city name. For example, "Tokyo".
|
|
*/
|
|
displayName?: string | null;
|
|
/**
|
|
* Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"\}
|
|
*/
|
|
labels?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* The canonical id for this location. For example: `"us-east1"`.
|
|
*/
|
|
locationId?: string | null;
|
|
/**
|
|
* Service-specific metadata. For example the available capacity at the given location.
|
|
*/
|
|
metadata?: {
|
|
[key: string]: any;
|
|
} | null;
|
|
/**
|
|
* Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"`
|
|
*/
|
|
name?: string | null;
|
|
}
|
|
/**
|
|
* 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
|
|
*/
|
|
export interface Schema$GoogleTypeDate {
|
|
/**
|
|
* 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.
|
|
*/
|
|
day?: number | null;
|
|
/**
|
|
* Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
|
|
*/
|
|
month?: number | null;
|
|
/**
|
|
* Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
|
|
*/
|
|
year?: number | null;
|
|
}
|
|
/**
|
|
* 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`.
|
|
*/
|
|
export interface Schema$GoogleTypeTimeOfDay {
|
|
/**
|
|
* 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.
|
|
*/
|
|
hours?: number | null;
|
|
/**
|
|
* Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
|
|
*/
|
|
minutes?: number | null;
|
|
/**
|
|
* Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
|
|
*/
|
|
nanos?: number | null;
|
|
/**
|
|
* 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.
|
|
*/
|
|
seconds?: number | null;
|
|
}
|
|
/**
|
|
* Import cluster request.
|
|
*/
|
|
export interface Schema$ImportClusterRequest {
|
|
/**
|
|
* Options for importing data in CSV format.
|
|
*/
|
|
csvImportOptions?: Schema$CsvImportOptions;
|
|
/**
|
|
* Optional. Name of the database to which the import will be done. For import from SQL file, this is required only if the file does not specify a database. Note - Value provided should be the same as expected from `SELECT current_database();` and NOT as a resource reference.
|
|
*/
|
|
database?: string | null;
|
|
/**
|
|
* Required. The path to the file in Google Cloud Storage where the source file for import will be stored. The URI is in the form `gs://bucketName/fileName`.
|
|
*/
|
|
gcsUri?: string | null;
|
|
/**
|
|
* Options for importing data in SQL format.
|
|
*/
|
|
sqlImportOptions?: Schema$SqlImportOptions;
|
|
/**
|
|
* Optional. Database user to be used for importing the data. Note - Value provided should be the same as expected from `SELECT current_user;` and NOT as a resource reference.
|
|
*/
|
|
user?: string | null;
|
|
}
|
|
/**
|
|
* Response of import rpc.
|
|
*/
|
|
export interface Schema$ImportClusterResponse {
|
|
/**
|
|
* Required. Size of the object downloaded from Google Cloud Storage in bytes.
|
|
*/
|
|
bytesDownloaded?: string | null;
|
|
}
|
|
/**
|
|
* Message for triggering fault injection on an instance
|
|
*/
|
|
export interface Schema$InjectFaultRequest {
|
|
/**
|
|
* Required. The type of fault to be injected in an instance.
|
|
*/
|
|
faultType?: string | null;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string | null;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean | null;
|
|
}
|
|
/**
|
|
* An Instance is a computing unit that an end customer can connect to. It's the main unit of computing resources in AlloyDB.
|
|
*/
|
|
export interface Schema$Instance {
|
|
/**
|
|
* Optional. Specifies whether an instance needs to spin up. Once the instance is active, the activation policy can be updated to the `NEVER` to stop the instance. Likewise, the activation policy can be updated to `ALWAYS` to start the instance. There are restrictions around when an instance can/cannot be activated (for example, a read pool instance should be stopped before stopping primary etc.). Please refer to the API documentation for more details.
|
|
*/
|
|
activationPolicy?: string | null;
|
|
/**
|
|
* Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128
|
|
*/
|
|
annotations?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Availability type of an Instance. If empty, defaults to REGIONAL for primary instances. For read pools, availability_type is always UNSPECIFIED. Instances in the read pools are evenly distributed across available zones within the region (i.e. read pools with more than one node will have a node in at least two zones).
|
|
*/
|
|
availabilityType?: string | null;
|
|
/**
|
|
* Optional. Client connection specific configurations
|
|
*/
|
|
clientConnectionConfig?: Schema$ClientConnectionConfig;
|
|
/**
|
|
* Optional. The configuration for Managed Connection Pool (MCP).
|
|
*/
|
|
connectionPoolConfig?: Schema$ConnectionPoolConfig;
|
|
/**
|
|
* Output only. Create time stamp
|
|
*/
|
|
createTime?: string | null;
|
|
/**
|
|
* Database flags. Set at the instance level. They are copied from the primary instance on secondary instance creation. Flags that have restrictions default to the value at primary instance on read instances during creation. Read instances can set new flags or override existing flags that are relevant for reads, for example, for enabling columnar cache on a read instance. Flags set on read instance might or might not be present on the primary instance. This is a list of "key": "value" pairs. "key": The name of the flag. These flags are passed at instance setup time, so include both server options and system variables for Postgres. Flags are specified with underscores, not hyphens. "value": The value of the flag. Booleans are set to **on** for true and **off** for false. This field must be omitted if the flag doesn't take a value.
|
|
*/
|
|
databaseFlags?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Output only. Delete time stamp
|
|
*/
|
|
deleteTime?: string | null;
|
|
/**
|
|
* User-settable and human-readable display name for the Instance.
|
|
*/
|
|
displayName?: string | null;
|
|
/**
|
|
* For Resource freshness validation (https://google.aip.dev/154)
|
|
*/
|
|
etag?: string | null;
|
|
/**
|
|
* The Compute Engine zone that the instance should serve from, per https://cloud.google.com/compute/docs/regions-zones This can ONLY be specified for ZONAL instances. If present for a REGIONAL instance, an error will be thrown. If this is absent for a ZONAL instance, instance is created in a random zone with available capacity.
|
|
*/
|
|
gceZone?: string | null;
|
|
/**
|
|
* Required. The type of the instance. Specified at creation time.
|
|
*/
|
|
instanceType?: string | null;
|
|
/**
|
|
* Output only. The IP address for the Instance. This is the connection endpoint for an end-user application.
|
|
*/
|
|
ipAddress?: string | null;
|
|
/**
|
|
* Labels as key value pairs
|
|
*/
|
|
labels?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
/**
|
|
* Configurations for the machines that host the underlying database engine.
|
|
*/
|
|
machineConfig?: Schema$MachineConfig;
|
|
/**
|
|
* Output only. Maintenance version of the instance, for example: POSTGRES_15.2025_07_15.04_00. Output only. Update this field via the parent cluster's maintenance_version field(s).
|
|
*/
|
|
maintenanceVersionName?: string | null;
|
|
/**
|
|
* Output only. The name of the instance resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}/instances/{instance_id\} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Optional. Instance-level network configuration.
|
|
*/
|
|
networkConfig?: Schema$InstanceNetworkConfig;
|
|
/**
|
|
* Output only. List of available read-only VMs in this instance, including the standby for a PRIMARY instance.
|
|
*/
|
|
nodes?: Schema$Node[];
|
|
/**
|
|
* Configuration for observability.
|
|
*/
|
|
observabilityConfig?: Schema$ObservabilityInstanceConfig;
|
|
/**
|
|
* Output only. All outbound public IP addresses configured for the instance.
|
|
*/
|
|
outboundPublicIpAddresses?: string[] | null;
|
|
/**
|
|
* Optional. The configuration for Private Service Connect (PSC) for the instance.
|
|
*/
|
|
pscInstanceConfig?: Schema$PscInstanceConfig;
|
|
/**
|
|
* Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application.
|
|
*/
|
|
publicIpAddress?: string | null;
|
|
/**
|
|
* Configuration for query insights.
|
|
*/
|
|
queryInsightsConfig?: Schema$QueryInsightsInstanceConfig;
|
|
/**
|
|
* Read pool instance configuration. This is required if the value of instanceType is READ_POOL.
|
|
*/
|
|
readPoolConfig?: Schema$ReadPoolConfig;
|
|
/**
|
|
* Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Instance does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.
|
|
*/
|
|
reconciling?: boolean | null;
|
|
/**
|
|
* Output only. Reserved for future use.
|
|
*/
|
|
satisfiesPzs?: boolean | null;
|
|
/**
|
|
* Output only. The current serving state of the instance.
|
|
*/
|
|
state?: string | null;
|
|
/**
|
|
* Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.
|
|
*/
|
|
uid?: string | null;
|
|
/**
|
|
* Output only. Update time stamp
|
|
*/
|
|
updateTime?: string | null;
|
|
/**
|
|
* Output only. This is set for the read-write VM of the PRIMARY instance only.
|
|
*/
|
|
writableNode?: Schema$Node;
|
|
}
|
|
/**
|
|
* Metadata related to instance-level network configuration.
|
|
*/
|
|
export interface Schema$InstanceNetworkConfig {
|
|
/**
|
|
* Optional. Name of the allocated IP range for the private IP AlloyDB instance, for example: "google-managed-services-default". If set, the instance IPs will be created from this allocated range and will override the IP range used by the parent cluster. The range name must comply with [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?.
|
|
*/
|
|
allocatedIpRangeOverride?: string | null;
|
|
/**
|
|
* Optional. A list of external network authorized to access this instance.
|
|
*/
|
|
authorizedExternalNetworks?: Schema$AuthorizedNetwork[];
|
|
/**
|
|
* Optional. Enabling an outbound public IP address to support a database server sending requests out into the internet.
|
|
*/
|
|
enableOutboundPublicIp?: boolean | null;
|
|
/**
|
|
* Optional. Enabling public ip for the instance.
|
|
*/
|
|
enablePublicIp?: boolean | null;
|
|
/**
|
|
* Output only. The resource link for the VPC network in which instance resources are created and from which they are accessible via Private IP. This will be the same value as the parent cluster's network. It is specified in the form: // `projects/{project_number\}/global/networks/{network_id\}`.
|
|
*/
|
|
network?: string | null;
|
|
}
|
|
/**
|
|
* Details regarding the upgrade of instances associated with a cluster.
|
|
*/
|
|
export interface Schema$InstanceUpgradeDetails {
|
|
/**
|
|
* Instance type.
|
|
*/
|
|
instanceType?: string | null;
|
|
/**
|
|
* Normalized name of the instance.
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Upgrade status of the instance.
|
|
*/
|
|
upgradeStatus?: string | null;
|
|
}
|
|
/**
|
|
* Restrictions on INTEGER type values.
|
|
*/
|
|
export interface Schema$IntegerRestrictions {
|
|
/**
|
|
* The maximum value that can be specified, if applicable.
|
|
*/
|
|
maxValue?: string | null;
|
|
/**
|
|
* The minimum value that can be specified, if applicable.
|
|
*/
|
|
minValue?: string | null;
|
|
}
|
|
/**
|
|
* Message for response to listing Backups
|
|
*/
|
|
export interface Schema$ListBackupsResponse {
|
|
/**
|
|
* The list of Backup
|
|
*/
|
|
backups?: Schema$Backup[];
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
nextPageToken?: string | null;
|
|
/**
|
|
* Locations that could not be reached.
|
|
*/
|
|
unreachable?: string[] | null;
|
|
}
|
|
/**
|
|
* Message for response to listing Clusters
|
|
*/
|
|
export interface Schema$ListClustersResponse {
|
|
/**
|
|
* The list of Cluster
|
|
*/
|
|
clusters?: Schema$Cluster[];
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
nextPageToken?: string | null;
|
|
/**
|
|
* Locations that could not be reached.
|
|
*/
|
|
unreachable?: string[] | null;
|
|
}
|
|
/**
|
|
* Message for response to listing Instances
|
|
*/
|
|
export interface Schema$ListInstancesResponse {
|
|
/**
|
|
* The list of Instance
|
|
*/
|
|
instances?: Schema$Instance[];
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
nextPageToken?: string | null;
|
|
/**
|
|
* Locations that could not be reached.
|
|
*/
|
|
unreachable?: string[] | null;
|
|
}
|
|
/**
|
|
* The response message for Operations.ListOperations.
|
|
*/
|
|
export interface Schema$ListOperationsResponse {
|
|
/**
|
|
* The standard List next-page token.
|
|
*/
|
|
nextPageToken?: string | null;
|
|
/**
|
|
* A list of operations that matches the specified filter in the request.
|
|
*/
|
|
operations?: Schema$Operation[];
|
|
/**
|
|
* 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.
|
|
*/
|
|
unreachable?: string[] | null;
|
|
}
|
|
/**
|
|
* Message for response to listing SupportedDatabaseFlags.
|
|
*/
|
|
export interface Schema$ListSupportedDatabaseFlagsResponse {
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
nextPageToken?: string | null;
|
|
/**
|
|
* The list of SupportedDatabaseFlags.
|
|
*/
|
|
supportedDatabaseFlags?: Schema$SupportedDatabaseFlag[];
|
|
}
|
|
/**
|
|
* Message for response to listing Users
|
|
*/
|
|
export interface Schema$ListUsersResponse {
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
nextPageToken?: string | null;
|
|
/**
|
|
* Locations that could not be reached.
|
|
*/
|
|
unreachable?: string[] | null;
|
|
/**
|
|
* The list of User
|
|
*/
|
|
users?: Schema$User[];
|
|
}
|
|
/**
|
|
* MachineConfig describes the configuration of a machine.
|
|
*/
|
|
export interface Schema$MachineConfig {
|
|
/**
|
|
* The number of CPU's in the VM instance.
|
|
*/
|
|
cpuCount?: number | null;
|
|
/**
|
|
* Machine type of the VM instance. E.g. "n2-highmem-4", "n2-highmem-8", "c4a-highmem-4-lssd". cpu_count must match the number of vCPUs in the machine type.
|
|
*/
|
|
machineType?: string | null;
|
|
}
|
|
/**
|
|
* MaintenanceSchedule stores the maintenance schedule generated from the MaintenanceUpdatePolicy, once a maintenance rollout is triggered, if MaintenanceWindow is set, and if there is no conflicting DenyPeriod. The schedule is cleared once the update takes place. This field cannot be manually changed; modify the MaintenanceUpdatePolicy instead.
|
|
*/
|
|
export interface Schema$MaintenanceSchedule {
|
|
/**
|
|
* Output only. The scheduled start time for the maintenance.
|
|
*/
|
|
startTime?: string | null;
|
|
}
|
|
/**
|
|
* MaintenanceUpdatePolicy defines the policy for system updates.
|
|
*/
|
|
export interface Schema$MaintenanceUpdatePolicy {
|
|
/**
|
|
* Periods to deny maintenance. Currently limited to 1.
|
|
*/
|
|
denyMaintenancePeriods?: Schema$DenyMaintenancePeriod[];
|
|
/**
|
|
* Preferred windows to perform maintenance. Currently limited to 1.
|
|
*/
|
|
maintenanceWindows?: Schema$MaintenanceWindow[];
|
|
}
|
|
/**
|
|
* MaintenanceWindow specifies a preferred day and time for maintenance.
|
|
*/
|
|
export interface Schema$MaintenanceWindow {
|
|
/**
|
|
* Preferred day of the week for maintenance, e.g. MONDAY, TUESDAY, etc.
|
|
*/
|
|
day?: string | null;
|
|
/**
|
|
* Preferred time to start the maintenance operation on the specified day. Maintenance will start within 1 hour of this time.
|
|
*/
|
|
startTime?: Schema$GoogleTypeTimeOfDay;
|
|
}
|
|
/**
|
|
* Subset of the source instance configuration that is available when reading the cluster resource.
|
|
*/
|
|
export interface Schema$MigrationSource {
|
|
/**
|
|
* Output only. The host and port of the on-premises instance in host:port format
|
|
*/
|
|
hostPort?: string | null;
|
|
/**
|
|
* Output only. Place holder for the external source identifier(e.g DMS job name) that created the cluster.
|
|
*/
|
|
referenceId?: string | null;
|
|
/**
|
|
* Output only. Type of migration source.
|
|
*/
|
|
sourceType?: string | null;
|
|
}
|
|
/**
|
|
* Metadata related to network configuration.
|
|
*/
|
|
export interface Schema$NetworkConfig {
|
|
/**
|
|
* Optional. Name of the allocated IP range for the private IP AlloyDB cluster, for example: "google-managed-services-default". If set, the instance IPs for this cluster will be created in the allocated range. The range name must comply with RFC 1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. Field name is intended to be consistent with Cloud SQL.
|
|
*/
|
|
allocatedIpRange?: string | null;
|
|
/**
|
|
* Optional. The resource link for the VPC network in which cluster resources are created and from which they are accessible via Private IP. The network must belong to the same project as the cluster. It is specified in the form: `projects/{project_number\}/global/networks/{network_id\}`. This is required to create a cluster.
|
|
*/
|
|
network?: string | null;
|
|
}
|
|
/**
|
|
* Details of a single node in the instance. Nodes in an AlloyDB instance are ephemeral, they can change during update, failover, autohealing and resize operations.
|
|
*/
|
|
export interface Schema$Node {
|
|
/**
|
|
* Output only. The identifier of the VM e.g. "test-read-0601-407e52be-ms3l".
|
|
*/
|
|
id?: string | null;
|
|
/**
|
|
* Output only. The private IP address of the VM e.g. "10.57.0.34".
|
|
*/
|
|
ip?: string | null;
|
|
/**
|
|
* Output only. Determined by state of the compute VM and postgres-service health. Compute VM state can have values listed in https://cloud.google.com/compute/docs/instances/instance-life-cycle and postgres-service health can have values: HEALTHY and UNHEALTHY.
|
|
*/
|
|
state?: string | null;
|
|
/**
|
|
* Output only. The Compute Engine zone of the VM e.g. "us-central1-b".
|
|
*/
|
|
zoneId?: string | null;
|
|
}
|
|
/**
|
|
* Observability Instance specific configuration.
|
|
*/
|
|
export interface Schema$ObservabilityInstanceConfig {
|
|
/**
|
|
* Observability feature status for an instance. This flag is turned "off" by default.
|
|
*/
|
|
enabled?: boolean | null;
|
|
/**
|
|
* Query string length. The default value is 10k.
|
|
*/
|
|
maxQueryStringLength?: number | null;
|
|
/**
|
|
* Preserve comments in query string for an instance. This flag is turned "off" by default.
|
|
*/
|
|
preserveComments?: boolean | null;
|
|
/**
|
|
* Number of query execution plans captured by Insights per minute for all queries combined. The default value is 200. Any integer between 0 to 200 is considered valid.
|
|
*/
|
|
queryPlansPerMinute?: number | null;
|
|
/**
|
|
* Record application tags for an instance. This flag is turned "off" by default.
|
|
*/
|
|
recordApplicationTags?: boolean | null;
|
|
/**
|
|
* Track actively running queries on the instance. If not set, this flag is "off" by default.
|
|
*/
|
|
trackActiveQueries?: boolean | null;
|
|
/**
|
|
* Track wait events during query execution for an instance. This flag is turned "on" by default but tracking is enabled only after observability enabled flag is also turned on.
|
|
*/
|
|
trackWaitEvents?: boolean | null;
|
|
/**
|
|
* Output only. Track wait event types during query execution for an instance. This flag is turned "on" by default but tracking is enabled only after observability enabled flag is also turned on. This is read-only flag and only modifiable by internal API.
|
|
*/
|
|
trackWaitEventTypes?: boolean | null;
|
|
}
|
|
/**
|
|
* This resource represents a long-running operation that is the result of a network API call.
|
|
*/
|
|
export interface Schema$Operation {
|
|
/**
|
|
* 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.
|
|
*/
|
|
done?: boolean | null;
|
|
/**
|
|
* The error result of the operation in case of failure or cancellation.
|
|
*/
|
|
error?: Schema$Status;
|
|
/**
|
|
* Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
|
|
*/
|
|
metadata?: {
|
|
[key: string]: any;
|
|
} | null;
|
|
/**
|
|
* 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\}`.
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* 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`.
|
|
*/
|
|
response?: {
|
|
[key: string]: any;
|
|
} | null;
|
|
}
|
|
/**
|
|
* Represents the metadata of the long-running operation.
|
|
*/
|
|
export interface Schema$OperationMetadata {
|
|
/**
|
|
* Output only. API version used to start the operation.
|
|
*/
|
|
apiVersion?: string | null;
|
|
/**
|
|
* Output only. The time the operation was created.
|
|
*/
|
|
createTime?: string | null;
|
|
/**
|
|
* Output only. The time the operation finished running.
|
|
*/
|
|
endTime?: string | null;
|
|
/**
|
|
* Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
|
|
*/
|
|
requestedCancellation?: boolean | null;
|
|
/**
|
|
* Output only. Human-readable status of the operation, if any.
|
|
*/
|
|
statusMessage?: string | null;
|
|
/**
|
|
* Output only. Server-defined resource path for the target of the operation.
|
|
*/
|
|
target?: string | null;
|
|
/**
|
|
* Output only. UpgradeClusterStatus related metadata.
|
|
*/
|
|
upgradeClusterStatus?: Schema$UpgradeClusterStatus;
|
|
/**
|
|
* Output only. Name of the verb executed by the operation.
|
|
*/
|
|
verb?: string | null;
|
|
}
|
|
/**
|
|
* Configuration for the primary cluster. It has the list of clusters that are replicating from this cluster. This should be set if and only if the cluster is of type PRIMARY.
|
|
*/
|
|
export interface Schema$PrimaryConfig {
|
|
/**
|
|
* Output only. Names of the clusters that are replicating from this cluster.
|
|
*/
|
|
secondaryClusterNames?: string[] | null;
|
|
}
|
|
/**
|
|
* Message for promoting a Cluster
|
|
*/
|
|
export interface Schema$PromoteClusterRequest {
|
|
/**
|
|
* Optional. The current etag of the Cluster. If an etag is provided and does not match the current etag of the Cluster, deletion will be blocked and an ABORTED error will be returned.
|
|
*/
|
|
etag?: string | null;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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).
|
|
*/
|
|
requestId?: string | null;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean | null;
|
|
}
|
|
/**
|
|
* Configuration for setting up PSC service automation. Consumer projects in the configs will be allowlisted automatically for the instance.
|
|
*/
|
|
export interface Schema$PscAutoConnectionConfig {
|
|
/**
|
|
* The consumer network for the PSC service automation, example: "projects/vpc-host-project/global/networks/default". The consumer network might be hosted a different project than the consumer project.
|
|
*/
|
|
consumerNetwork?: string | null;
|
|
/**
|
|
* Output only. The status of the service connection policy. Possible values: "STATE_UNSPECIFIED" - Default state, when Connection Map is created initially. "VALID" - Set when policy and map configuration is valid, and their matching can lead to allowing creation of PSC Connections subject to other constraints like connections limit. "CONNECTION_POLICY_MISSING" - No Service Connection Policy found for this network and Service Class "POLICY_LIMIT_REACHED" - Service Connection Policy limit reached for this network and Service Class "CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED" - The consumer instance project is not in AllowedGoogleProducersResourceHierarchyLevels of the matching ServiceConnectionPolicy.
|
|
*/
|
|
consumerNetworkStatus?: string | null;
|
|
/**
|
|
* The consumer project to which the PSC service automation endpoint will be created.
|
|
*/
|
|
consumerProject?: string | null;
|
|
/**
|
|
* Output only. The IP address of the PSC service automation endpoint.
|
|
*/
|
|
ipAddress?: string | null;
|
|
/**
|
|
* Output only. The status of the PSC service automation connection. Possible values: "STATE_UNSPECIFIED" - An invalid state as the default case. "ACTIVE" - The connection has been created successfully. "FAILED" - The connection is not functional since some resources on the connection fail to be created. "CREATING" - The connection is being created. "DELETING" - The connection is being deleted. "CREATE_REPAIRING" - The connection is being repaired to complete creation. "DELETE_REPAIRING" - The connection is being repaired to complete deletion.
|
|
*/
|
|
status?: string | null;
|
|
}
|
|
/**
|
|
* PscConfig contains PSC related configuration at a cluster level.
|
|
*/
|
|
export interface Schema$PscConfig {
|
|
/**
|
|
* Optional. Create an instance that allows connections from Private Service Connect endpoints to the instance.
|
|
*/
|
|
pscEnabled?: boolean | null;
|
|
/**
|
|
* Output only. The project number that needs to be allowlisted on the network attachment to enable outbound connectivity.
|
|
*/
|
|
serviceOwnedProjectNumber?: string | null;
|
|
}
|
|
/**
|
|
* PscInstanceConfig contains PSC related configuration at an instance level.
|
|
*/
|
|
export interface Schema$PscInstanceConfig {
|
|
/**
|
|
* Optional. List of consumer projects that are allowed to create PSC endpoints to service-attachments to this instance.
|
|
*/
|
|
allowedConsumerProjects?: string[] | null;
|
|
/**
|
|
* Optional. Configurations for setting up PSC service automation.
|
|
*/
|
|
pscAutoConnections?: Schema$PscAutoConnectionConfig[];
|
|
/**
|
|
* Output only. The DNS name of the instance for PSC connectivity. Name convention: ...alloydb-psc.goog
|
|
*/
|
|
pscDnsName?: string | null;
|
|
/**
|
|
* Optional. Configurations for setting up PSC interfaces attached to the instance which are used for outbound connectivity. Only primary instances can have PSC interface attached. Currently we only support 0 or 1 PSC interface.
|
|
*/
|
|
pscInterfaceConfigs?: Schema$PscInterfaceConfig[];
|
|
/**
|
|
* Output only. The service attachment created when Private Service Connect (PSC) is enabled for the instance. The name of the resource will be in the format of `projects//regions//serviceAttachments/`
|
|
*/
|
|
serviceAttachmentLink?: string | null;
|
|
}
|
|
/**
|
|
* Configuration for setting up a PSC interface to enable outbound connectivity.
|
|
*/
|
|
export interface Schema$PscInterfaceConfig {
|
|
/**
|
|
* The network attachment resource created in the consumer network to which the PSC interface will be linked. This is of the format: "projects/${CONSUMER_PROJECT\}/regions/${REGION\}/networkAttachments/${NETWORK_ATTACHMENT_NAME\}". The network attachment must be in the same region as the instance.
|
|
*/
|
|
networkAttachmentResource?: string | null;
|
|
}
|
|
/**
|
|
* A backup's position in a quantity-based retention queue, of backups with the same source cluster and type, with length, retention, specified by the backup's retention policy. Once the position is greater than the retention, the backup is eligible to be garbage collected. Example: 5 backups from the same source cluster and type with a quantity-based retention of 3 and denoted by backup_id (position, retention). Safe: backup_5 (1, 3), backup_4, (2, 3), backup_3 (3, 3). Awaiting garbage collection: backup_2 (4, 3), backup_1 (5, 3)
|
|
*/
|
|
export interface Schema$QuantityBasedExpiry {
|
|
/**
|
|
* Output only. The backup's position among its backups with the same source cluster and type, by descending chronological order create time(i.e. newest first).
|
|
*/
|
|
retentionCount?: number | null;
|
|
/**
|
|
* Output only. The length of the quantity-based queue, specified by the backup's retention policy.
|
|
*/
|
|
totalRetentionCount?: number | null;
|
|
}
|
|
/**
|
|
* A quantity based policy specifies that a certain number of the most recent successful backups should be retained.
|
|
*/
|
|
export interface Schema$QuantityBasedRetention {
|
|
/**
|
|
* The number of backups to retain.
|
|
*/
|
|
count?: number | null;
|
|
}
|
|
/**
|
|
* QueryInsights Instance specific configuration.
|
|
*/
|
|
export interface Schema$QueryInsightsInstanceConfig {
|
|
/**
|
|
* Number of query execution plans captured by Insights per minute for all queries combined. The default value is 5. Any integer between 0 and 20 is considered valid.
|
|
*/
|
|
queryPlansPerMinute?: number | null;
|
|
/**
|
|
* Query string length. The default value is 1024. Any integer between 256 and 4500 is considered valid.
|
|
*/
|
|
queryStringLength?: number | null;
|
|
/**
|
|
* Record application tags for an instance. This flag is turned "on" by default.
|
|
*/
|
|
recordApplicationTags?: boolean | null;
|
|
/**
|
|
* Record client address for an instance. Client address is PII information. This flag is turned "on" by default.
|
|
*/
|
|
recordClientAddress?: boolean | null;
|
|
}
|
|
/**
|
|
* Configuration for a read pool instance.
|
|
*/
|
|
export interface Schema$ReadPoolConfig {
|
|
/**
|
|
* Read capacity, i.e. number of nodes in a read pool instance.
|
|
*/
|
|
nodeCount?: number | null;
|
|
}
|
|
/**
|
|
* Read pool instances upgrade specific status.
|
|
*/
|
|
export interface Schema$ReadPoolInstancesUpgradeStageStatus {
|
|
/**
|
|
* Read pool instances upgrade statistics.
|
|
*/
|
|
upgradeStats?: Schema$Stats;
|
|
}
|
|
export interface Schema$RestartInstanceRequest {
|
|
/**
|
|
* Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Applicable only to read instances.
|
|
*/
|
|
nodeIds?: string[] | null;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string | null;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean | null;
|
|
}
|
|
/**
|
|
* Message for restoring a Cluster from a backup or another cluster at a given point in time. NEXT_ID: 11
|
|
*/
|
|
export interface Schema$RestoreClusterRequest {
|
|
/**
|
|
* BackupDR backup source.
|
|
*/
|
|
backupdrBackupSource?: Schema$BackupDrBackupSource;
|
|
/**
|
|
* BackupDR source used for point in time recovery.
|
|
*/
|
|
backupdrPitrSource?: Schema$BackupDrPitrSource;
|
|
/**
|
|
* Backup source.
|
|
*/
|
|
backupSource?: Schema$BackupSource;
|
|
/**
|
|
* Required. The resource being created
|
|
*/
|
|
cluster?: Schema$Cluster;
|
|
/**
|
|
* Required. ID of the requesting object.
|
|
*/
|
|
clusterId?: string | null;
|
|
/**
|
|
* ContinuousBackup source. Continuous backup needs to be enabled in the source cluster for this operation to succeed.
|
|
*/
|
|
continuousBackupSource?: Schema$ContinuousBackupSource;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string | null;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean | null;
|
|
}
|
|
/**
|
|
* Message for registering Restoring from CloudSQL resource.
|
|
*/
|
|
export interface Schema$RestoreFromCloudSQLRequest {
|
|
/**
|
|
* Cluster created from CloudSQL backup run.
|
|
*/
|
|
cloudsqlBackupRunSource?: Schema$CloudSQLBackupRunSource;
|
|
/**
|
|
* Required. The resource being created
|
|
*/
|
|
cluster?: Schema$Cluster;
|
|
/**
|
|
* Required. ID of the requesting object.
|
|
*/
|
|
clusterId?: string | null;
|
|
}
|
|
/**
|
|
* Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.
|
|
*/
|
|
export interface Schema$SecondaryConfig {
|
|
/**
|
|
* The name of the primary cluster name with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}
|
|
*/
|
|
primaryClusterName?: string | null;
|
|
}
|
|
/**
|
|
* Options for exporting data in SQL format.
|
|
*/
|
|
export interface Schema$SqlExportOptions {
|
|
/**
|
|
* Optional. If true, output commands to DROP all the dumped database objects prior to outputting the commands for creating them.
|
|
*/
|
|
cleanTargetObjects?: boolean | null;
|
|
/**
|
|
* Optional. If true, use DROP ... IF EXISTS commands to check for the object's existence before dropping it in clean_target_objects mode.
|
|
*/
|
|
ifExistTargetObjects?: boolean | null;
|
|
/**
|
|
* Optional. If true, only export the schema.
|
|
*/
|
|
schemaOnly?: boolean | null;
|
|
/**
|
|
* Optional. Tables to export from.
|
|
*/
|
|
tables?: string[] | null;
|
|
}
|
|
/**
|
|
* Options for importing data in SQL format.
|
|
*/
|
|
export interface Schema$SqlImportOptions {
|
|
}
|
|
/**
|
|
* SSL configuration.
|
|
*/
|
|
export interface Schema$SslConfig {
|
|
/**
|
|
* Optional. Certificate Authority (CA) source. Only CA_SOURCE_MANAGED is supported currently, and is the default value.
|
|
*/
|
|
caSource?: string | null;
|
|
/**
|
|
* Optional. SSL mode. Specifies client-server SSL/TLS connection behavior.
|
|
*/
|
|
sslMode?: string | null;
|
|
}
|
|
/**
|
|
* Stage information for different stages in the upgrade process.
|
|
*/
|
|
export interface Schema$StageInfo {
|
|
/**
|
|
* logs_url is the URL for the logs associated with a stage if that stage has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK, PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE.
|
|
*/
|
|
logsUrl?: string | null;
|
|
/**
|
|
* The stage.
|
|
*/
|
|
stage?: string | null;
|
|
/**
|
|
* Status of the stage.
|
|
*/
|
|
status?: string | null;
|
|
}
|
|
/**
|
|
* Status of an upgrade stage.
|
|
*/
|
|
export interface Schema$StageStatus {
|
|
/**
|
|
* Read pool instances upgrade metadata.
|
|
*/
|
|
readPoolInstancesUpgrade?: Schema$ReadPoolInstancesUpgradeStageStatus;
|
|
/**
|
|
* Upgrade stage.
|
|
*/
|
|
stage?: string | null;
|
|
/**
|
|
* State of this stage.
|
|
*/
|
|
state?: string | null;
|
|
}
|
|
/**
|
|
* Upgrade stats for read pool instances.
|
|
*/
|
|
export interface Schema$Stats {
|
|
/**
|
|
* Number of read pool instances which failed to upgrade.
|
|
*/
|
|
failed?: number | null;
|
|
/**
|
|
* Number of read pool instances for which upgrade has not started.
|
|
*/
|
|
notStarted?: number | null;
|
|
/**
|
|
* Number of read pool instances undergoing upgrade.
|
|
*/
|
|
ongoing?: number | null;
|
|
/**
|
|
* Number of read pool instances successfully upgraded.
|
|
*/
|
|
success?: number | null;
|
|
}
|
|
/**
|
|
* The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
|
|
*/
|
|
export interface Schema$Status {
|
|
/**
|
|
* The status code, which should be an enum value of google.rpc.Code.
|
|
*/
|
|
code?: number | null;
|
|
/**
|
|
* A list of messages that carry the error details. There is a common set of message types for APIs to use.
|
|
*/
|
|
details?: Array<{
|
|
[key: string]: any;
|
|
}> | null;
|
|
/**
|
|
* 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.
|
|
*/
|
|
message?: string | null;
|
|
}
|
|
/**
|
|
* Configuration for availability of database instance
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainAvailabilityConfiguration {
|
|
/**
|
|
* 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.
|
|
*/
|
|
automaticFailoverRoutingConfigured?: boolean | null;
|
|
/**
|
|
* 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).
|
|
*/
|
|
availabilityType?: string | null;
|
|
/**
|
|
* Checks for resources that are configured to have redundancy, and ongoing replication across regions
|
|
*/
|
|
crossRegionReplicaConfigured?: boolean | null;
|
|
externalReplicaConfigured?: boolean | null;
|
|
promotableReplicaConfigured?: boolean | null;
|
|
}
|
|
/**
|
|
* Configuration for automatic backups
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainBackupConfiguration {
|
|
/**
|
|
* Whether customer visible automated backups are enabled on the instance.
|
|
*/
|
|
automatedBackupEnabled?: boolean | null;
|
|
/**
|
|
* Backup retention settings.
|
|
*/
|
|
backupRetentionSettings?: Schema$StorageDatabasecenterPartnerapiV1mainRetentionSettings;
|
|
/**
|
|
* 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.
|
|
*/
|
|
pointInTimeRecoveryEnabled?: boolean | null;
|
|
}
|
|
/**
|
|
* BackupDRConfiguration to capture the backup and disaster recovery details of database resource.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration {
|
|
/**
|
|
* Indicates if the resource is managed by BackupDR.
|
|
*/
|
|
backupdrManaged?: boolean | null;
|
|
}
|
|
/**
|
|
* BackupDRMetadata contains information about the backup and disaster recovery metadata of a database resource.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainBackupDRMetadata {
|
|
/**
|
|
* Backup configuration for this instance.
|
|
*/
|
|
backupConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainBackupConfiguration;
|
|
/**
|
|
* BackupDR configuration for this instance.
|
|
*/
|
|
backupdrConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration;
|
|
/**
|
|
* Latest backup run information for this instance.
|
|
*/
|
|
backupRun?: Schema$StorageDatabasecenterPartnerapiV1mainBackupRun;
|
|
/**
|
|
* Required. Full resource name of this instance.
|
|
*/
|
|
fullResourceName?: string | null;
|
|
/**
|
|
* Required. Last time backup configuration was refreshed.
|
|
*/
|
|
lastRefreshTime?: string | null;
|
|
/**
|
|
* Required. Database resource id.
|
|
*/
|
|
resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
}
|
|
/**
|
|
* A backup run.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainBackupRun {
|
|
/**
|
|
* The time the backup operation completed. REQUIRED
|
|
*/
|
|
endTime?: string | null;
|
|
/**
|
|
* Information about why the backup operation failed. This is only present if the run has the FAILED status. OPTIONAL
|
|
*/
|
|
error?: Schema$StorageDatabasecenterPartnerapiV1mainOperationError;
|
|
/**
|
|
* The time the backup operation started. REQUIRED
|
|
*/
|
|
startTime?: string | null;
|
|
/**
|
|
* The status of this run. REQUIRED
|
|
*/
|
|
status?: string | null;
|
|
}
|
|
/**
|
|
* BigQueryResourceMetadata contains information about the BigQuery resource. Next ID: 9
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainBigQueryResourceMetadata {
|
|
/**
|
|
* The creation time of the resource, i.e. the time when resource is created and recorded in partner service.
|
|
*/
|
|
createTime?: string | null;
|
|
/**
|
|
* Required. Full resource name of this instance.
|
|
*/
|
|
fullResourceName?: string | null;
|
|
/**
|
|
* Required. location of the resource
|
|
*/
|
|
location?: string | null;
|
|
/**
|
|
* The product this resource represents.
|
|
*/
|
|
product?: Schema$StorageDatabasecenterProtoCommonProduct;
|
|
/**
|
|
* 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.
|
|
*/
|
|
resourceContainer?: string | null;
|
|
/**
|
|
* Required. Database resource id.
|
|
*/
|
|
resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
/**
|
|
* The time at which the resource was updated and recorded at partner service.
|
|
*/
|
|
updateTime?: string | null;
|
|
/**
|
|
* User-provided labels associated with the resource
|
|
*/
|
|
userLabelSet?: Schema$StorageDatabasecenterPartnerapiV1mainUserLabels;
|
|
}
|
|
/**
|
|
* Contains compliance information about a security standard indicating unmet recommendations.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainCompliance {
|
|
/**
|
|
* Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
|
|
*/
|
|
standard?: string | null;
|
|
/**
|
|
* Version of the standard or benchmark, for example, 1.1
|
|
*/
|
|
version?: string | null;
|
|
}
|
|
/**
|
|
* 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.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData {
|
|
/**
|
|
* Required. Full Resource name of the source resource.
|
|
*/
|
|
fullResourceName?: string | null;
|
|
/**
|
|
* Required. Last time signal was refreshed
|
|
*/
|
|
lastRefreshTime?: string | null;
|
|
/**
|
|
* Database resource id.
|
|
*/
|
|
resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
/**
|
|
* Signal data for boolean signals.
|
|
*/
|
|
signalBoolValue?: boolean | null;
|
|
/**
|
|
* Required. Signal type of the signal
|
|
*/
|
|
signalType?: string | null;
|
|
}
|
|
/**
|
|
* 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
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainCustomMetadataData {
|
|
/**
|
|
* Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration.
|
|
*/
|
|
internalResourceMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata[];
|
|
}
|
|
/**
|
|
* DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 13
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed {
|
|
/**
|
|
* BackupDR metadata is used to ingest metadata from BackupDR.
|
|
*/
|
|
backupdrMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainBackupDRMetadata;
|
|
/**
|
|
* For BigQuery resource metadata.
|
|
*/
|
|
bigqueryResourceMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainBigQueryResourceMetadata;
|
|
/**
|
|
* Config based signal data is used to ingest signals that are generated based on the configuration of the database resource.
|
|
*/
|
|
configBasedSignalData?: Schema$StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData;
|
|
/**
|
|
* Database resource signal data is used to ingest signals from database resource signal feeds.
|
|
*/
|
|
databaseResourceSignalData?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceSignalData;
|
|
/**
|
|
* Required. Timestamp when feed is generated.
|
|
*/
|
|
feedTimestamp?: string | null;
|
|
/**
|
|
* Required. Type feed to be ingested into condor
|
|
*/
|
|
feedType?: string | null;
|
|
observabilityMetricData?: Schema$StorageDatabasecenterPartnerapiV1mainObservabilityMetricData;
|
|
recommendationSignalData?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData;
|
|
resourceHealthSignalData?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData;
|
|
/**
|
|
* Primary key associated with the Resource. resource_id is available in individual feed level as well.
|
|
*/
|
|
resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
resourceMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata;
|
|
/**
|
|
* 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.
|
|
*/
|
|
skipIngestion?: boolean | null;
|
|
}
|
|
/**
|
|
* Common model for database resource health signal data.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData {
|
|
/**
|
|
* Any other additional metadata
|
|
*/
|
|
additionalMetadata?: {
|
|
[key: string]: any;
|
|
} | null;
|
|
/**
|
|
* 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.
|
|
*/
|
|
compliance?: Schema$StorageDatabasecenterPartnerapiV1mainCompliance[];
|
|
/**
|
|
* Description associated with signal
|
|
*/
|
|
description?: string | null;
|
|
/**
|
|
* Required. The last time at which the event described by this signal took place
|
|
*/
|
|
eventTime?: string | null;
|
|
/**
|
|
* 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.
|
|
*/
|
|
externalUri?: string | null;
|
|
/**
|
|
* This is used to identify the location of the resource. Example: "us-central1"
|
|
*/
|
|
location?: string | null;
|
|
/**
|
|
* Required. The name of the signal, ex: PUBLIC_SQL_INSTANCE, SQL_LOG_ERROR_VERBOSITY etc.
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Cloud provider name. Ex: GCP/AWS/Azure/OnPrem/SelfManaged
|
|
*/
|
|
provider?: string | null;
|
|
/**
|
|
* 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.
|
|
*/
|
|
resourceContainer?: string | null;
|
|
/**
|
|
* Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel
|
|
*/
|
|
resourceName?: string | null;
|
|
/**
|
|
* Required. The class of the signal, such as if it's a THREAT or VULNERABILITY.
|
|
*/
|
|
signalClass?: string | null;
|
|
/**
|
|
* Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.
|
|
*/
|
|
signalId?: string | null;
|
|
/**
|
|
* The severity of the signal, such as if it's a HIGH or LOW severity.
|
|
*/
|
|
signalSeverity?: string | null;
|
|
/**
|
|
* Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.
|
|
*/
|
|
signalType?: string | null;
|
|
state?: string | null;
|
|
}
|
|
/**
|
|
* DatabaseResourceId will serve as primary key for any resource ingestion event.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId {
|
|
/**
|
|
* Required. Cloud provider name. Ex: GCP/AWS/Azure/OnPrem/SelfManaged
|
|
*/
|
|
provider?: string | null;
|
|
/**
|
|
* Optional. Needs to be used only when the provider is PROVIDER_OTHER.
|
|
*/
|
|
providerDescription?: string | null;
|
|
/**
|
|
* Required. The type of resource this ID is identifying. Ex go/keep-sorted start alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, bigquery.googleapis.com/Dataset, 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
|
|
*/
|
|
resourceType?: string | null;
|
|
/**
|
|
* Required. A service-local token that distinguishes this resource from other resources within the same service.
|
|
*/
|
|
uniqueId?: string | null;
|
|
}
|
|
/**
|
|
* Common model for database resource instance metadata. Next ID: 30
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata {
|
|
/**
|
|
* Availability configuration for this instance
|
|
*/
|
|
availabilityConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainAvailabilityConfiguration;
|
|
/**
|
|
* Backup configuration for this instance
|
|
*/
|
|
backupConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainBackupConfiguration;
|
|
/**
|
|
* Optional. BackupDR Configuration for the resource.
|
|
*/
|
|
backupdrConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration;
|
|
/**
|
|
* Latest backup run information for this instance
|
|
*/
|
|
backupRun?: Schema$StorageDatabasecenterPartnerapiV1mainBackupRun;
|
|
/**
|
|
* The creation time of the resource, i.e. the time when resource is created and recorded in partner service.
|
|
*/
|
|
creationTime?: string | null;
|
|
/**
|
|
* Current state of the instance.
|
|
*/
|
|
currentState?: string | null;
|
|
/**
|
|
* Any custom metadata associated with the resource
|
|
*/
|
|
customMetadata?: Schema$StorageDatabasecenterPartnerapiV1mainCustomMetadataData;
|
|
/**
|
|
* 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.
|
|
*/
|
|
edition?: string | null;
|
|
/**
|
|
* Entitlements associated with the resource
|
|
*/
|
|
entitlements?: Schema$StorageDatabasecenterPartnerapiV1mainEntitlement[];
|
|
/**
|
|
* 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.
|
|
*/
|
|
expectedState?: string | null;
|
|
/**
|
|
* GCBDR configuration for the resource.
|
|
*/
|
|
gcbdrConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration;
|
|
/**
|
|
* Required. Unique identifier for a Database resource
|
|
*/
|
|
id?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
/**
|
|
* The type of the instance. Specified at creation time.
|
|
*/
|
|
instanceType?: string | null;
|
|
/**
|
|
* Optional. Whether deletion protection is enabled for this resource.
|
|
*/
|
|
isDeletionProtectionEnabled?: boolean | null;
|
|
/**
|
|
* The resource location. REQUIRED
|
|
*/
|
|
location?: string | null;
|
|
/**
|
|
* Machine configuration for this resource.
|
|
*/
|
|
machineConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainMachineConfiguration;
|
|
/**
|
|
* Optional. Maintenance info for the resource.
|
|
*/
|
|
maintenanceInfo?: Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceInfo;
|
|
/**
|
|
* 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.
|
|
*/
|
|
primaryResourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
/**
|
|
* Primary resource location. REQUIRED if the immediate parent exists when first time resource is getting ingested, otherwise optional.
|
|
*/
|
|
primaryResourceLocation?: string | null;
|
|
/**
|
|
* The product this resource represents.
|
|
*/
|
|
product?: Schema$StorageDatabasecenterProtoCommonProduct;
|
|
/**
|
|
* 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.
|
|
*/
|
|
resourceContainer?: string | null;
|
|
/**
|
|
* 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
|
|
*/
|
|
resourceName?: string | null;
|
|
/**
|
|
* Optional. Suspension reason for the resource.
|
|
*/
|
|
suspensionReason?: string | null;
|
|
/**
|
|
* Optional. Tags associated with this resources.
|
|
*/
|
|
tagsSet?: Schema$StorageDatabasecenterPartnerapiV1mainTags;
|
|
/**
|
|
* The time at which the resource was updated and recorded at partner service.
|
|
*/
|
|
updationTime?: string | null;
|
|
/**
|
|
* User-provided labels associated with the resource
|
|
*/
|
|
userLabelSet?: Schema$StorageDatabasecenterPartnerapiV1mainUserLabels;
|
|
/**
|
|
* The resource zone. This is only applicable for zonal resources and will be empty for regional and multi-regional resources.
|
|
*/
|
|
zone?: string | null;
|
|
}
|
|
/**
|
|
* Common model for database resource recommendation signal data.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData {
|
|
/**
|
|
* Optional. Any other additional metadata specific to recommendation
|
|
*/
|
|
additionalMetadata?: {
|
|
[key: string]: any;
|
|
} | null;
|
|
/**
|
|
* Required. last time recommendationw as refreshed
|
|
*/
|
|
lastRefreshTime?: string | null;
|
|
/**
|
|
* Required. Recommendation state
|
|
*/
|
|
recommendationState?: string | null;
|
|
/**
|
|
* Required. Name of recommendation. Examples: organizations/1234/locations/us-central1/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations/9876
|
|
*/
|
|
recommender?: string | null;
|
|
/**
|
|
* Required. ID of recommender. Examples: "google.cloudsql.instance.PerformanceRecommender"
|
|
*/
|
|
recommenderId?: string | null;
|
|
/**
|
|
* 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"
|
|
*/
|
|
recommenderSubtype?: string | null;
|
|
/**
|
|
* Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel
|
|
*/
|
|
resourceName?: string | null;
|
|
/**
|
|
* Required. Type of signal, for example, `SIGNAL_TYPE_IDLE`, `SIGNAL_TYPE_HIGH_NUMBER_OF_TABLES`, etc.
|
|
*/
|
|
signalType?: string | null;
|
|
}
|
|
/**
|
|
* 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: 7
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceSignalData {
|
|
/**
|
|
* Required. Full Resource name of the source resource.
|
|
*/
|
|
fullResourceName?: string | null;
|
|
/**
|
|
* Required. Last time signal was refreshed
|
|
*/
|
|
lastRefreshTime?: string | null;
|
|
/**
|
|
* Database resource id.
|
|
*/
|
|
resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
/**
|
|
* Signal data for boolean signals.
|
|
*/
|
|
signalBoolValue?: boolean | null;
|
|
/**
|
|
* Required. Output only. Signal state of the signal
|
|
*/
|
|
signalState?: string | null;
|
|
/**
|
|
* Required. Signal type of the signal
|
|
*/
|
|
signalType?: string | null;
|
|
}
|
|
/**
|
|
* Proto representing the access that a user has to a specific feature/service. NextId: 3.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainEntitlement {
|
|
/**
|
|
* The current state of user's accessibility to a feature/benefit.
|
|
*/
|
|
entitlementState?: string | null;
|
|
/**
|
|
* An enum that represents the type of this entitlement.
|
|
*/
|
|
type?: string | null;
|
|
}
|
|
/**
|
|
* GCBDR Configuration for the resource.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration {
|
|
/**
|
|
* Whether the resource is managed by GCBDR.
|
|
*/
|
|
gcbdrManaged?: boolean | null;
|
|
}
|
|
/**
|
|
* 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.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata {
|
|
/**
|
|
* Backup configuration for this database
|
|
*/
|
|
backupConfiguration?: Schema$StorageDatabasecenterPartnerapiV1mainBackupConfiguration;
|
|
/**
|
|
* Information about the last backup attempt for this database
|
|
*/
|
|
backupRun?: Schema$StorageDatabasecenterPartnerapiV1mainBackupRun;
|
|
/**
|
|
* Whether deletion protection is enabled for this internal resource.
|
|
*/
|
|
isDeletionProtectionEnabled?: boolean | null;
|
|
product?: Schema$StorageDatabasecenterProtoCommonProduct;
|
|
resourceId?: Schema$StorageDatabasecenterPartnerapiV1mainDatabaseResourceId;
|
|
/**
|
|
* Required. internal resource name for spanner this will be database name e.g."spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1"
|
|
*/
|
|
resourceName?: string | null;
|
|
}
|
|
/**
|
|
* MachineConfiguration describes the configuration of a machine specific to Database Resource.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainMachineConfiguration {
|
|
/**
|
|
* The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482) add proto validations again after bug fix.
|
|
*/
|
|
cpuCount?: number | null;
|
|
/**
|
|
* Memory size in bytes. TODO(b/342344482) add proto validations again after bug fix.
|
|
*/
|
|
memorySizeInBytes?: string | null;
|
|
/**
|
|
* Optional. Number of shards (if applicable).
|
|
*/
|
|
shardCount?: number | null;
|
|
/**
|
|
* Optional. The number of vCPUs. TODO(b/342344482) add proto validations again after bug fix.
|
|
*/
|
|
vcpuCount?: number | null;
|
|
}
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainObservabilityMetricData {
|
|
/**
|
|
* Required. Type of aggregation performed on the metric.
|
|
*/
|
|
aggregationType?: string | null;
|
|
/**
|
|
* Required. Type of metric like CPU, Memory, etc.
|
|
*/
|
|
metricType?: string | null;
|
|
/**
|
|
* Required. The time the metric value was observed.
|
|
*/
|
|
observationTime?: string | null;
|
|
/**
|
|
* Required. Database resource name associated with the signal. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel
|
|
*/
|
|
resourceName?: string | null;
|
|
/**
|
|
* Required. Value of the metric type.
|
|
*/
|
|
value?: Schema$StorageDatabasecenterProtoCommonTypedValue;
|
|
}
|
|
/**
|
|
* An error that occurred during a backup creation operation.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainOperationError {
|
|
/**
|
|
* Identifies the specific error that occurred. REQUIRED
|
|
*/
|
|
code?: string | null;
|
|
errorType?: string | null;
|
|
/**
|
|
* Additional information about the error encountered. REQUIRED
|
|
*/
|
|
message?: string | null;
|
|
}
|
|
/**
|
|
* Deny maintenance period for the database resource. It specifies the time range during which the maintenance cannot start. This is configured by the customer.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceDenySchedule {
|
|
/**
|
|
* Optional. Deny period end date.
|
|
*/
|
|
endDate?: Schema$GoogleTypeDate;
|
|
/**
|
|
* Optional. The start date of the deny maintenance period.
|
|
*/
|
|
startDate?: Schema$GoogleTypeDate;
|
|
/**
|
|
* Optional. Time in UTC when the deny period starts on start_date and ends on end_date.
|
|
*/
|
|
time?: Schema$GoogleTypeTimeOfDay;
|
|
}
|
|
/**
|
|
* MaintenanceInfo to capture the maintenance details of database resource.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceInfo {
|
|
/**
|
|
* Optional. List of Deny maintenance period for the database resource.
|
|
*/
|
|
denyMaintenanceSchedules?: Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceDenySchedule[];
|
|
/**
|
|
* Optional. Maintenance window for the database resource.
|
|
*/
|
|
maintenanceSchedule?: Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceSchedule;
|
|
/**
|
|
* Optional. Current Maintenance version of the database resource. Example: "MYSQL_8_0_41.R20250531.01_15"
|
|
*/
|
|
maintenanceVersion?: string | null;
|
|
}
|
|
/**
|
|
* 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.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainResourceMaintenanceSchedule {
|
|
/**
|
|
* Optional. Preferred day of the week for maintenance, e.g. MONDAY, TUESDAY, etc.
|
|
*/
|
|
day?: string | null;
|
|
/**
|
|
* 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
|
|
*/
|
|
phase?: string | null;
|
|
/**
|
|
* Optional. Preferred time to start the maintenance operation on the specified day.
|
|
*/
|
|
time?: Schema$GoogleTypeTimeOfDay;
|
|
}
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainRetentionSettings {
|
|
/**
|
|
* Duration based retention period i.e. 172800 seconds (2 days)
|
|
*/
|
|
durationBasedRetention?: string | null;
|
|
quantityBasedRetention?: number | null;
|
|
/**
|
|
* The unit that 'retained_backups' represents.
|
|
*/
|
|
retentionUnit?: string | null;
|
|
timeBasedRetention?: string | null;
|
|
/**
|
|
* Timestamp based retention period i.e. 2024-05-01T00:00:00Z
|
|
*/
|
|
timestampBasedRetentionTime?: string | null;
|
|
}
|
|
/**
|
|
* 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.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainTags {
|
|
/**
|
|
* The Tag key/value mappings.
|
|
*/
|
|
tags?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
}
|
|
/**
|
|
* 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.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterPartnerapiV1mainUserLabels {
|
|
labels?: {
|
|
[key: string]: string;
|
|
} | null;
|
|
}
|
|
/**
|
|
* Product specification for Condor resources.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterProtoCommonProduct {
|
|
/**
|
|
* The specific engine that the underlying database is running.
|
|
*/
|
|
engine?: string | null;
|
|
/**
|
|
* 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..
|
|
*/
|
|
minorVersion?: string | null;
|
|
/**
|
|
* Type of specific database product. It could be CloudSQL, AlloyDB etc..
|
|
*/
|
|
type?: string | null;
|
|
/**
|
|
* 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..
|
|
*/
|
|
version?: string | null;
|
|
}
|
|
/**
|
|
* TypedValue represents the value of a metric type. It can either be a double, an int64, a string or a bool.
|
|
*/
|
|
export interface Schema$StorageDatabasecenterProtoCommonTypedValue {
|
|
/**
|
|
* For boolean value
|
|
*/
|
|
boolValue?: boolean | null;
|
|
/**
|
|
* For double value
|
|
*/
|
|
doubleValue?: number | null;
|
|
/**
|
|
* For integer value
|
|
*/
|
|
int64Value?: string | null;
|
|
/**
|
|
* For string value
|
|
*/
|
|
stringValue?: string | null;
|
|
}
|
|
/**
|
|
* Restrictions on STRING type values
|
|
*/
|
|
export interface Schema$StringRestrictions {
|
|
/**
|
|
* The list of allowed values, if bounded. This field will be empty if there is a unbounded number of allowed values.
|
|
*/
|
|
allowedValues?: string[] | null;
|
|
}
|
|
/**
|
|
* SupportedDatabaseFlag gives general information about a database flag, like type and allowed values. This is a static value that is defined on the server side, and it cannot be modified by callers. To set the Database flags on a particular Instance, a caller should modify the Instance.database_flags field.
|
|
*/
|
|
export interface Schema$SupportedDatabaseFlag {
|
|
/**
|
|
* Whether the database flag accepts multiple values. If true, a comma-separated list of stringified values may be specified.
|
|
*/
|
|
acceptsMultipleValues?: boolean | null;
|
|
/**
|
|
* The name of the database flag, e.g. "max_allowed_packets". The is a possibly key for the Instance.database_flags map field.
|
|
*/
|
|
flagName?: string | null;
|
|
/**
|
|
* Restriction on INTEGER type value.
|
|
*/
|
|
integerRestrictions?: Schema$IntegerRestrictions;
|
|
/**
|
|
* The name of the flag resource, following Google Cloud conventions, e.g.: * projects/{project\}/locations/{location\}/flags/{flag\} This field currently has no semantic meaning.
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* The recommended value for an INTEGER flag.
|
|
*/
|
|
recommendedIntegerValue?: string | null;
|
|
/**
|
|
* The recommended value for a STRING flag.
|
|
*/
|
|
recommendedStringValue?: string | null;
|
|
/**
|
|
* Whether setting or updating this flag on an Instance requires a database restart. If a flag that requires database restart is set, the backend will automatically restart the database (making sure to satisfy any availability SLO's).
|
|
*/
|
|
requiresDbRestart?: boolean | null;
|
|
/**
|
|
* The scope of the flag.
|
|
*/
|
|
scope?: string | null;
|
|
/**
|
|
* Restriction on STRING type value.
|
|
*/
|
|
stringRestrictions?: Schema$StringRestrictions;
|
|
/**
|
|
* Major database engine versions for which this flag is supported.
|
|
*/
|
|
supportedDbVersions?: string[] | null;
|
|
valueType?: string | null;
|
|
}
|
|
/**
|
|
* Message for switching over to a cluster
|
|
*/
|
|
export interface Schema$SwitchoverClusterRequest {
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string | null;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean | null;
|
|
}
|
|
/**
|
|
* A time based retention policy specifies that all backups within a certain time period should be retained.
|
|
*/
|
|
export interface Schema$TimeBasedRetention {
|
|
/**
|
|
* The retention period.
|
|
*/
|
|
retentionPeriod?: string | null;
|
|
}
|
|
/**
|
|
* Contains information and all metadata related to TRIAL clusters.
|
|
*/
|
|
export interface Schema$TrialMetadata {
|
|
/**
|
|
* End time of the trial cluster.
|
|
*/
|
|
endTime?: string | null;
|
|
/**
|
|
* grace end time of the cluster.
|
|
*/
|
|
graceEndTime?: string | null;
|
|
/**
|
|
* start time of the trial cluster.
|
|
*/
|
|
startTime?: string | null;
|
|
/**
|
|
* Upgrade time of trial cluster to Standard cluster.
|
|
*/
|
|
upgradeTime?: string | null;
|
|
}
|
|
/**
|
|
* Upgrades a cluster.
|
|
*/
|
|
export interface Schema$UpgradeClusterRequest {
|
|
/**
|
|
* Optional. The current etag of the Cluster. If an etag is provided and does not match the current etag of the Cluster, upgrade will be blocked and an ABORTED error will be returned.
|
|
*/
|
|
etag?: string | null;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string | null;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean | null;
|
|
/**
|
|
* Required. The version the cluster is going to be upgraded to.
|
|
*/
|
|
version?: string | null;
|
|
}
|
|
/**
|
|
* UpgradeClusterResponse contains the response for upgrade cluster operation.
|
|
*/
|
|
export interface Schema$UpgradeClusterResponse {
|
|
/**
|
|
* Array of upgrade details for the current cluster and all the secondary clusters associated with this cluster.
|
|
*/
|
|
clusterUpgradeDetails?: Schema$ClusterUpgradeDetails[];
|
|
/**
|
|
* A user friendly message summarising the upgrade operation details and the next steps for the user if there is any.
|
|
*/
|
|
message?: string | null;
|
|
/**
|
|
* Status of upgrade operation.
|
|
*/
|
|
status?: string | null;
|
|
}
|
|
/**
|
|
* Message for current status of the Major Version Upgrade operation.
|
|
*/
|
|
export interface Schema$UpgradeClusterStatus {
|
|
/**
|
|
* Whether the operation is cancellable.
|
|
*/
|
|
cancellable?: boolean | null;
|
|
/**
|
|
* Source database major version.
|
|
*/
|
|
sourceVersion?: string | null;
|
|
/**
|
|
* Status of all upgrade stages.
|
|
*/
|
|
stages?: Schema$StageStatus[];
|
|
/**
|
|
* Cluster Major Version Upgrade state.
|
|
*/
|
|
state?: string | null;
|
|
/**
|
|
* Target database major version.
|
|
*/
|
|
targetVersion?: string | null;
|
|
}
|
|
/**
|
|
* Message describing User object.
|
|
*/
|
|
export interface Schema$User {
|
|
/**
|
|
* Optional. List of database roles this user has. The database role strings are subject to the PostgreSQL naming conventions.
|
|
*/
|
|
databaseRoles?: string[] | null;
|
|
/**
|
|
* Input only. If the user already exists and it has additional roles, keep them granted.
|
|
*/
|
|
keepExtraRoles?: boolean | null;
|
|
/**
|
|
* Output only. Name of the resource in the form of projects/{project\}/locations/{location\}/cluster/{cluster\}/users/{user\}.
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Input only. Password for the user.
|
|
*/
|
|
password?: string | null;
|
|
/**
|
|
* Optional. Type of this user.
|
|
*/
|
|
userType?: string | null;
|
|
}
|
|
/**
|
|
* The username/password for a database user. Used for specifying initial users at cluster creation time.
|
|
*/
|
|
export interface Schema$UserPassword {
|
|
/**
|
|
* The initial password for the user.
|
|
*/
|
|
password?: string | null;
|
|
/**
|
|
* The database username.
|
|
*/
|
|
user?: string | null;
|
|
}
|
|
/**
|
|
* A weekly schedule starts a backup at prescribed start times within a day, for the specified days of the week. The weekly schedule message is flexible and can be used to create many types of schedules. For example, to have a daily backup that starts at 22:00, configure the `start_times` field to have one element "22:00" and the `days_of_week` field to have all seven days of the week.
|
|
*/
|
|
export interface Schema$WeeklySchedule {
|
|
/**
|
|
* The days of the week to perform a backup. If this field is left empty, the default of every day of the week is used.
|
|
*/
|
|
daysOfWeek?: string[] | null;
|
|
/**
|
|
* The times during the day to start a backup. The start times are assumed to be in UTC and to be an exact hour (e.g., 04:00:00). If no start times are provided, a single fixed start time is chosen arbitrarily.
|
|
*/
|
|
startTimes?: Schema$GoogleTypeTimeOfDay[];
|
|
}
|
|
export class Resource$Projects {
|
|
context: APIRequestContext;
|
|
locations: Resource$Projects$Locations;
|
|
constructor(context: APIRequestContext);
|
|
}
|
|
export class Resource$Projects$Locations {
|
|
context: APIRequestContext;
|
|
backups: Resource$Projects$Locations$Backups;
|
|
clusters: Resource$Projects$Locations$Clusters;
|
|
operations: Resource$Projects$Locations$Operations;
|
|
supportedDatabaseFlags: Resource$Projects$Locations$Supporteddatabaseflags;
|
|
constructor(context: APIRequestContext);
|
|
/**
|
|
* Gets information about a location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.get({
|
|
* // Resource name for the location.
|
|
* name: 'projects/my-project/locations/my-location',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "displayName": "my_displayName",
|
|
* // "labels": {},
|
|
* // "locationId": "my_locationId",
|
|
* // "metadata": {},
|
|
* // "name": "my_name"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
get(params: Params$Resource$Projects$Locations$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
get(params?: Params$Resource$Projects$Locations$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudLocationLocation>>;
|
|
get(params: Params$Resource$Projects$Locations$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
get(params: Params$Resource$Projects$Locations$Get, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudLocationLocation>, callback: BodyResponseCallback<Schema$GoogleCloudLocationLocation>): void;
|
|
get(params: Params$Resource$Projects$Locations$Get, callback: BodyResponseCallback<Schema$GoogleCloudLocationLocation>): void;
|
|
get(callback: BodyResponseCallback<Schema$GoogleCloudLocationLocation>): void;
|
|
/**
|
|
* Lists information about the supported locations for this service.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.list({
|
|
* // Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
|
|
* extraLocationTypes: 'placeholder-value',
|
|
* // 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).
|
|
* filter: 'placeholder-value',
|
|
* // The resource that owns the locations collection, if applicable.
|
|
* name: 'projects/my-project',
|
|
* // The maximum number of results to return. If not set, the service selects a default.
|
|
* pageSize: 'placeholder-value',
|
|
* // A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
|
|
* pageToken: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "locations": [],
|
|
* // "nextPageToken": "my_nextPageToken"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
list(params: Params$Resource$Projects$Locations$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
list(params?: Params$Resource$Projects$Locations$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudLocationListLocationsResponse>>;
|
|
list(params: Params$Resource$Projects$Locations$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
list(params: Params$Resource$Projects$Locations$List, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudLocationListLocationsResponse>, callback: BodyResponseCallback<Schema$GoogleCloudLocationListLocationsResponse>): void;
|
|
list(params: Params$Resource$Projects$Locations$List, callback: BodyResponseCallback<Schema$GoogleCloudLocationListLocationsResponse>): void;
|
|
list(callback: BodyResponseCallback<Schema$GoogleCloudLocationListLocationsResponse>): void;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Get extends StandardParameters {
|
|
/**
|
|
* Resource name for the location.
|
|
*/
|
|
name?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$List extends StandardParameters {
|
|
/**
|
|
* Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
|
|
*/
|
|
extraLocationTypes?: string[];
|
|
/**
|
|
* 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).
|
|
*/
|
|
filter?: string;
|
|
/**
|
|
* The resource that owns the locations collection, if applicable.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* The maximum number of results to return. If not set, the service selects a default.
|
|
*/
|
|
pageSize?: number;
|
|
/**
|
|
* A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
|
|
*/
|
|
pageToken?: string;
|
|
}
|
|
export class Resource$Projects$Locations$Backups {
|
|
context: APIRequestContext;
|
|
constructor(context: APIRequestContext);
|
|
/**
|
|
* Creates a new Backup in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.backups.create({
|
|
* // Required. ID of the requesting object.
|
|
* backupId: 'placeholder-value',
|
|
* // Required. Value for parent.
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "annotations": {},
|
|
* // "clusterName": "my_clusterName",
|
|
* // "clusterUid": "my_clusterUid",
|
|
* // "createCompletionTime": "my_createCompletionTime",
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseVersion": "my_databaseVersion",
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "description": "my_description",
|
|
* // "displayName": "my_displayName",
|
|
* // "encryptionConfig": {},
|
|
* // "encryptionInfo": {},
|
|
* // "etag": "my_etag",
|
|
* // "expiryQuantity": {},
|
|
* // "expiryTime": "my_expiryTime",
|
|
* // "labels": {},
|
|
* // "name": "my_name",
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "sizeBytes": "my_sizeBytes",
|
|
* // "state": "my_state",
|
|
* // "tags": {},
|
|
* // "type": "my_type",
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
create(params: Params$Resource$Projects$Locations$Backups$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
create(params?: Params$Resource$Projects$Locations$Backups$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
create(params: Params$Resource$Projects$Locations$Backups$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
create(params: Params$Resource$Projects$Locations$Backups$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
create(params: Params$Resource$Projects$Locations$Backups$Create, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
create(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Deletes a single Backup.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.backups.delete({
|
|
* // Optional. The current etag of the Backup. If an etag is provided and does not match the current etag of the Backup, deletion will be blocked and an ABORTED error will be returned.
|
|
* etag: 'placeholder-value',
|
|
* // Required. Name of the resource. For the required format, see the comment on the Backup.name field.
|
|
* name: 'projects/my-project/locations/my-location/backups/my-backup',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
* validateOnly: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
delete(params: Params$Resource$Projects$Locations$Backups$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
delete(params?: Params$Resource$Projects$Locations$Backups$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
delete(params: Params$Resource$Projects$Locations$Backups$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Backups$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Backups$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
delete(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Gets details of a single Backup.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.backups.get({
|
|
* // Required. Name of the resource
|
|
* name: 'projects/my-project/locations/my-location/backups/my-backup',
|
|
* // Optional. The view of the backup to return.
|
|
* view: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "annotations": {},
|
|
* // "clusterName": "my_clusterName",
|
|
* // "clusterUid": "my_clusterUid",
|
|
* // "createCompletionTime": "my_createCompletionTime",
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseVersion": "my_databaseVersion",
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "description": "my_description",
|
|
* // "displayName": "my_displayName",
|
|
* // "encryptionConfig": {},
|
|
* // "encryptionInfo": {},
|
|
* // "etag": "my_etag",
|
|
* // "expiryQuantity": {},
|
|
* // "expiryTime": "my_expiryTime",
|
|
* // "labels": {},
|
|
* // "name": "my_name",
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "sizeBytes": "my_sizeBytes",
|
|
* // "state": "my_state",
|
|
* // "tags": {},
|
|
* // "type": "my_type",
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
get(params: Params$Resource$Projects$Locations$Backups$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
get(params?: Params$Resource$Projects$Locations$Backups$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Backup>>;
|
|
get(params: Params$Resource$Projects$Locations$Backups$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
get(params: Params$Resource$Projects$Locations$Backups$Get, options: MethodOptions | BodyResponseCallback<Schema$Backup>, callback: BodyResponseCallback<Schema$Backup>): void;
|
|
get(params: Params$Resource$Projects$Locations$Backups$Get, callback: BodyResponseCallback<Schema$Backup>): void;
|
|
get(callback: BodyResponseCallback<Schema$Backup>): void;
|
|
/**
|
|
* Lists Backups in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.backups.list({
|
|
* // Filtering results
|
|
* filter: 'placeholder-value',
|
|
* // Hint for how to order the results
|
|
* orderBy: 'placeholder-value',
|
|
* // Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
* pageSize: 'placeholder-value',
|
|
* // A token identifying a page of results the server should return.
|
|
* pageToken: 'placeholder-value',
|
|
* // Required. Parent value for ListBackupsRequest
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
* // Optional. The view of the backup to return.
|
|
* view: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "backups": [],
|
|
* // "nextPageToken": "my_nextPageToken",
|
|
* // "unreachable": []
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
list(params: Params$Resource$Projects$Locations$Backups$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
list(params?: Params$Resource$Projects$Locations$Backups$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListBackupsResponse>>;
|
|
list(params: Params$Resource$Projects$Locations$Backups$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
list(params: Params$Resource$Projects$Locations$Backups$List, options: MethodOptions | BodyResponseCallback<Schema$ListBackupsResponse>, callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
|
|
list(params: Params$Resource$Projects$Locations$Backups$List, callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
|
|
list(callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
|
|
/**
|
|
* Updates the parameters of a single Backup.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.backups.patch({
|
|
* // Optional. If set to true, update succeeds even if instance is not found. In that case, a new backup is created and `update_mask` is ignored.
|
|
* allowMissing: 'placeholder-value',
|
|
* // Output only. The name of the backup resource with the format: * projects/{project\}/locations/{region\}/backups/{backup_id\} where the cluster and backup ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the backup resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
|
|
* name: 'projects/my-project/locations/my-location/backups/my-backup',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. Field mask is used to specify the fields to be overwritten in the Backup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
* updateMask: 'placeholder-value',
|
|
* // Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "annotations": {},
|
|
* // "clusterName": "my_clusterName",
|
|
* // "clusterUid": "my_clusterUid",
|
|
* // "createCompletionTime": "my_createCompletionTime",
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseVersion": "my_databaseVersion",
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "description": "my_description",
|
|
* // "displayName": "my_displayName",
|
|
* // "encryptionConfig": {},
|
|
* // "encryptionInfo": {},
|
|
* // "etag": "my_etag",
|
|
* // "expiryQuantity": {},
|
|
* // "expiryTime": "my_expiryTime",
|
|
* // "labels": {},
|
|
* // "name": "my_name",
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "sizeBytes": "my_sizeBytes",
|
|
* // "state": "my_state",
|
|
* // "tags": {},
|
|
* // "type": "my_type",
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
patch(params: Params$Resource$Projects$Locations$Backups$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
patch(params?: Params$Resource$Projects$Locations$Backups$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
patch(params: Params$Resource$Projects$Locations$Backups$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Backups$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Backups$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
patch(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Backups$Create extends StandardParameters {
|
|
/**
|
|
* Required. ID of the requesting object.
|
|
*/
|
|
backupId?: string;
|
|
/**
|
|
* Required. Value for parent.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Backup;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Backups$Delete extends StandardParameters {
|
|
/**
|
|
* Optional. The current etag of the Backup. If an etag is provided and does not match the current etag of the Backup, deletion will be blocked and an ABORTED error will be returned.
|
|
*/
|
|
etag?: string;
|
|
/**
|
|
* Required. Name of the resource. For the required format, see the comment on the Backup.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
*/
|
|
validateOnly?: boolean;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Backups$Get extends StandardParameters {
|
|
/**
|
|
* Required. Name of the resource
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. The view of the backup to return.
|
|
*/
|
|
view?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Backups$List extends StandardParameters {
|
|
/**
|
|
* Filtering results
|
|
*/
|
|
filter?: string;
|
|
/**
|
|
* Hint for how to order the results
|
|
*/
|
|
orderBy?: string;
|
|
/**
|
|
* Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
*/
|
|
pageSize?: number;
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
pageToken?: string;
|
|
/**
|
|
* Required. Parent value for ListBackupsRequest
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. The view of the backup to return.
|
|
*/
|
|
view?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Backups$Patch extends StandardParameters {
|
|
/**
|
|
* Optional. If set to true, update succeeds even if instance is not found. In that case, a new backup is created and `update_mask` is ignored.
|
|
*/
|
|
allowMissing?: boolean;
|
|
/**
|
|
* Output only. The name of the backup resource with the format: * projects/{project\}/locations/{region\}/backups/{backup_id\} where the cluster and backup ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the backup resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. Field mask is used to specify the fields to be overwritten in the Backup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
*/
|
|
updateMask?: string;
|
|
/**
|
|
* Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Backup;
|
|
}
|
|
export class Resource$Projects$Locations$Clusters {
|
|
context: APIRequestContext;
|
|
instances: Resource$Projects$Locations$Clusters$Instances;
|
|
users: Resource$Projects$Locations$Clusters$Users;
|
|
constructor(context: APIRequestContext);
|
|
/**
|
|
* Creates a new Cluster in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.create({
|
|
* // Required. ID of the requesting object.
|
|
* clusterId: 'placeholder-value',
|
|
* // Required. The location of the new cluster. For the required format, see the comment on the Cluster.name field.
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "annotations": {},
|
|
* // "automatedBackupPolicy": {},
|
|
* // "backupSource": {},
|
|
* // "backupdrBackupSource": {},
|
|
* // "backupdrInfo": {},
|
|
* // "cloudsqlBackupRunSource": {},
|
|
* // "clusterType": "my_clusterType",
|
|
* // "continuousBackupConfig": {},
|
|
* // "continuousBackupInfo": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseVersion": "my_databaseVersion",
|
|
* // "dataplexConfig": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "encryptionConfig": {},
|
|
* // "encryptionInfo": {},
|
|
* // "etag": "my_etag",
|
|
* // "initialUser": {},
|
|
* // "labels": {},
|
|
* // "maintenanceSchedule": {},
|
|
* // "maintenanceUpdatePolicy": {},
|
|
* // "maintenanceVersionSelectionPolicy": "my_maintenanceVersionSelectionPolicy",
|
|
* // "migrationSource": {},
|
|
* // "name": "my_name",
|
|
* // "network": "my_network",
|
|
* // "networkConfig": {},
|
|
* // "primaryConfig": {},
|
|
* // "pscConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "secondaryConfig": {},
|
|
* // "sslConfig": {},
|
|
* // "state": "my_state",
|
|
* // "subscriptionType": "my_subscriptionType",
|
|
* // "tags": {},
|
|
* // "trialMetadata": {},
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
create(params?: Params$Resource$Projects$Locations$Clusters$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Create, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
create(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Creates a cluster of type SECONDARY in the given location using the primary cluster as the source.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.createsecondary({
|
|
* // Required. ID of the requesting object (the secondary cluster).
|
|
* clusterId: 'placeholder-value',
|
|
* // Required. The location of the new cluster. For the required format, see the comment on the Cluster.name field.
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "annotations": {},
|
|
* // "automatedBackupPolicy": {},
|
|
* // "backupSource": {},
|
|
* // "backupdrBackupSource": {},
|
|
* // "backupdrInfo": {},
|
|
* // "cloudsqlBackupRunSource": {},
|
|
* // "clusterType": "my_clusterType",
|
|
* // "continuousBackupConfig": {},
|
|
* // "continuousBackupInfo": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseVersion": "my_databaseVersion",
|
|
* // "dataplexConfig": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "encryptionConfig": {},
|
|
* // "encryptionInfo": {},
|
|
* // "etag": "my_etag",
|
|
* // "initialUser": {},
|
|
* // "labels": {},
|
|
* // "maintenanceSchedule": {},
|
|
* // "maintenanceUpdatePolicy": {},
|
|
* // "maintenanceVersionSelectionPolicy": "my_maintenanceVersionSelectionPolicy",
|
|
* // "migrationSource": {},
|
|
* // "name": "my_name",
|
|
* // "network": "my_network",
|
|
* // "networkConfig": {},
|
|
* // "primaryConfig": {},
|
|
* // "pscConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "secondaryConfig": {},
|
|
* // "sslConfig": {},
|
|
* // "state": "my_state",
|
|
* // "subscriptionType": "my_subscriptionType",
|
|
* // "tags": {},
|
|
* // "trialMetadata": {},
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Createsecondary, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
createsecondary(params?: Params$Resource$Projects$Locations$Clusters$Createsecondary, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Createsecondary, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Createsecondary, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Createsecondary, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
createsecondary(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Deletes a single Cluster.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.delete({
|
|
* // Optional. The current etag of the Cluster. If an etag is provided and does not match the current etag of the Cluster, deletion will be blocked and an ABORTED error will be returned.
|
|
* etag: 'placeholder-value',
|
|
* // Optional. Whether to cascade delete child instances for given cluster.
|
|
* force: 'placeholder-value',
|
|
* // Required. The name of the resource. For the required format, see the comment on the Cluster.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
delete(params?: Params$Resource$Projects$Locations$Clusters$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
delete(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Exports data from the cluster. Imperative only.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.export({
|
|
* // Required. The resource name of the cluster.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "csvExportOptions": {},
|
|
* // "database": "my_database",
|
|
* // "gcsDestination": {},
|
|
* // "sqlExportOptions": {}
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
export(params: Params$Resource$Projects$Locations$Clusters$Export, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
export(params?: Params$Resource$Projects$Locations$Clusters$Export, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
export(params: Params$Resource$Projects$Locations$Clusters$Export, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
export(params: Params$Resource$Projects$Locations$Clusters$Export, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
export(params: Params$Resource$Projects$Locations$Clusters$Export, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
export(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Gets details of a single Cluster.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.get({
|
|
* // Required. The name of the resource. For the required format, see the comment on the Cluster.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* // Optional. The view of the cluster to return. Returns all default fields if not set.
|
|
* view: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "annotations": {},
|
|
* // "automatedBackupPolicy": {},
|
|
* // "backupSource": {},
|
|
* // "backupdrBackupSource": {},
|
|
* // "backupdrInfo": {},
|
|
* // "cloudsqlBackupRunSource": {},
|
|
* // "clusterType": "my_clusterType",
|
|
* // "continuousBackupConfig": {},
|
|
* // "continuousBackupInfo": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseVersion": "my_databaseVersion",
|
|
* // "dataplexConfig": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "encryptionConfig": {},
|
|
* // "encryptionInfo": {},
|
|
* // "etag": "my_etag",
|
|
* // "initialUser": {},
|
|
* // "labels": {},
|
|
* // "maintenanceSchedule": {},
|
|
* // "maintenanceUpdatePolicy": {},
|
|
* // "maintenanceVersionSelectionPolicy": "my_maintenanceVersionSelectionPolicy",
|
|
* // "migrationSource": {},
|
|
* // "name": "my_name",
|
|
* // "network": "my_network",
|
|
* // "networkConfig": {},
|
|
* // "primaryConfig": {},
|
|
* // "pscConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "secondaryConfig": {},
|
|
* // "sslConfig": {},
|
|
* // "state": "my_state",
|
|
* // "subscriptionType": "my_subscriptionType",
|
|
* // "tags": {},
|
|
* // "trialMetadata": {},
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
get(params?: Params$Resource$Projects$Locations$Clusters$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Cluster>>;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Get, options: MethodOptions | BodyResponseCallback<Schema$Cluster>, callback: BodyResponseCallback<Schema$Cluster>): void;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Get, callback: BodyResponseCallback<Schema$Cluster>): void;
|
|
get(callback: BodyResponseCallback<Schema$Cluster>): void;
|
|
/**
|
|
* Imports data to the cluster. Imperative only.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.import({
|
|
* // Required. The resource name of the cluster.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "csvImportOptions": {},
|
|
* // "database": "my_database",
|
|
* // "gcsUri": "my_gcsUri",
|
|
* // "sqlImportOptions": {},
|
|
* // "user": "my_user"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
import(params: Params$Resource$Projects$Locations$Clusters$Import, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
import(params?: Params$Resource$Projects$Locations$Clusters$Import, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
import(params: Params$Resource$Projects$Locations$Clusters$Import, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
import(params: Params$Resource$Projects$Locations$Clusters$Import, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
import(params: Params$Resource$Projects$Locations$Clusters$Import, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
import(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Lists Clusters in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.list({
|
|
* // Optional. Filtering results
|
|
* filter: 'placeholder-value',
|
|
* // Optional. Hint for how to order the results
|
|
* orderBy: 'placeholder-value',
|
|
* // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
* pageSize: 'placeholder-value',
|
|
* // A token identifying a page of results the server should return.
|
|
* pageToken: 'placeholder-value',
|
|
* // Required. The name of the parent resource. For the required format, see the comment on the Cluster.name field. Additionally, you can perform an aggregated list operation by specifying a value with the following format: * projects/{project\}/locations/-
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "clusters": [],
|
|
* // "nextPageToken": "my_nextPageToken",
|
|
* // "unreachable": []
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
list(params: Params$Resource$Projects$Locations$Clusters$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
list(params?: Params$Resource$Projects$Locations$Clusters$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListClustersResponse>>;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$List, options: MethodOptions | BodyResponseCallback<Schema$ListClustersResponse>, callback: BodyResponseCallback<Schema$ListClustersResponse>): void;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$List, callback: BodyResponseCallback<Schema$ListClustersResponse>): void;
|
|
list(callback: BodyResponseCallback<Schema$ListClustersResponse>): void;
|
|
/**
|
|
* Updates the parameters of a single Cluster.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.patch({
|
|
* // Optional. If set to true, update succeeds even if cluster is not found. In that case, a new cluster is created and `update_mask` is ignored.
|
|
* allowMissing: 'placeholder-value',
|
|
* // Output only. The name of the cluster resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\} where the cluster ID segment should satisfy the regex expression `[a-z0-9-]+`. For more details see https://google.aip.dev/122. The prefix of the cluster resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. Field mask is used to specify the fields to be overwritten in the Cluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
* updateMask: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "annotations": {},
|
|
* // "automatedBackupPolicy": {},
|
|
* // "backupSource": {},
|
|
* // "backupdrBackupSource": {},
|
|
* // "backupdrInfo": {},
|
|
* // "cloudsqlBackupRunSource": {},
|
|
* // "clusterType": "my_clusterType",
|
|
* // "continuousBackupConfig": {},
|
|
* // "continuousBackupInfo": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseVersion": "my_databaseVersion",
|
|
* // "dataplexConfig": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "encryptionConfig": {},
|
|
* // "encryptionInfo": {},
|
|
* // "etag": "my_etag",
|
|
* // "initialUser": {},
|
|
* // "labels": {},
|
|
* // "maintenanceSchedule": {},
|
|
* // "maintenanceUpdatePolicy": {},
|
|
* // "maintenanceVersionSelectionPolicy": "my_maintenanceVersionSelectionPolicy",
|
|
* // "migrationSource": {},
|
|
* // "name": "my_name",
|
|
* // "network": "my_network",
|
|
* // "networkConfig": {},
|
|
* // "primaryConfig": {},
|
|
* // "pscConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "secondaryConfig": {},
|
|
* // "sslConfig": {},
|
|
* // "state": "my_state",
|
|
* // "subscriptionType": "my_subscriptionType",
|
|
* // "tags": {},
|
|
* // "trialMetadata": {},
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
patch(params?: Params$Resource$Projects$Locations$Clusters$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
patch(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Promotes a SECONDARY cluster. This turns down replication from the PRIMARY cluster and promotes a secondary cluster into its own standalone cluster. Imperative only.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.promote({
|
|
* // Required. The name of the resource. For the required format, see the comment on the Cluster.name field
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "etag": "my_etag",
|
|
* // "requestId": "my_requestId",
|
|
* // "validateOnly": false
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
promote(params: Params$Resource$Projects$Locations$Clusters$Promote, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
promote(params?: Params$Resource$Projects$Locations$Clusters$Promote, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
promote(params: Params$Resource$Projects$Locations$Clusters$Promote, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
promote(params: Params$Resource$Projects$Locations$Clusters$Promote, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
promote(params: Params$Resource$Projects$Locations$Clusters$Promote, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
promote(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Creates a new Cluster in a given project and location, with a volume restored from the provided source, either a backup ID or a point-in-time and a source cluster.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.restore({
|
|
* // Required. The name of the parent resource. For the required format, see the comment on the Cluster.name field.
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "backupSource": {},
|
|
* // "backupdrBackupSource": {},
|
|
* // "backupdrPitrSource": {},
|
|
* // "cluster": {},
|
|
* // "clusterId": "my_clusterId",
|
|
* // "continuousBackupSource": {},
|
|
* // "requestId": "my_requestId",
|
|
* // "validateOnly": false
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
restore(params: Params$Resource$Projects$Locations$Clusters$Restore, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
restore(params?: Params$Resource$Projects$Locations$Clusters$Restore, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
restore(params: Params$Resource$Projects$Locations$Clusters$Restore, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
restore(params: Params$Resource$Projects$Locations$Clusters$Restore, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
restore(params: Params$Resource$Projects$Locations$Clusters$Restore, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
restore(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Restores an AlloyDB cluster from a CloudSQL resource.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.restoreFromCloudSQL({
|
|
* // Required. The location of the new cluster. For the required format, see the comment on Cluster.name field.
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "cloudsqlBackupRunSource": {},
|
|
* // "cluster": {},
|
|
* // "clusterId": "my_clusterId"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
restoreFromCloudSQL(params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
restoreFromCloudSQL(params?: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
restoreFromCloudSQL(params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
restoreFromCloudSQL(params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
restoreFromCloudSQL(params: Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
restoreFromCloudSQL(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Switches the roles of PRIMARY and SECONDARY clusters without any data loss. This promotes the SECONDARY cluster to PRIMARY and sets up the original PRIMARY cluster to replicate from this newly promoted cluster.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.switchover({
|
|
* // Required. The name of the resource. For the required format, see the comment on the Cluster.name field
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "requestId": "my_requestId",
|
|
* // "validateOnly": false
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
switchover(params: Params$Resource$Projects$Locations$Clusters$Switchover, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
switchover(params?: Params$Resource$Projects$Locations$Clusters$Switchover, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
switchover(params: Params$Resource$Projects$Locations$Clusters$Switchover, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
switchover(params: Params$Resource$Projects$Locations$Clusters$Switchover, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
switchover(params: Params$Resource$Projects$Locations$Clusters$Switchover, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
switchover(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Upgrades a single Cluster. Imperative only.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.upgrade({
|
|
* // Required. The resource name of the cluster.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "etag": "my_etag",
|
|
* // "requestId": "my_requestId",
|
|
* // "validateOnly": false,
|
|
* // "version": "my_version"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
upgrade(params: Params$Resource$Projects$Locations$Clusters$Upgrade, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
upgrade(params?: Params$Resource$Projects$Locations$Clusters$Upgrade, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
upgrade(params: Params$Resource$Projects$Locations$Clusters$Upgrade, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
upgrade(params: Params$Resource$Projects$Locations$Clusters$Upgrade, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
upgrade(params: Params$Resource$Projects$Locations$Clusters$Upgrade, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
upgrade(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Create extends StandardParameters {
|
|
/**
|
|
* Required. ID of the requesting object.
|
|
*/
|
|
clusterId?: string;
|
|
/**
|
|
* Required. The location of the new cluster. For the required format, see the comment on the Cluster.name field.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Cluster;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Createsecondary extends StandardParameters {
|
|
/**
|
|
* Required. ID of the requesting object (the secondary cluster).
|
|
*/
|
|
clusterId?: string;
|
|
/**
|
|
* Required. The location of the new cluster. For the required format, see the comment on the Cluster.name field.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Cluster;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Delete extends StandardParameters {
|
|
/**
|
|
* Optional. The current etag of the Cluster. If an etag is provided and does not match the current etag of the Cluster, deletion will be blocked and an ABORTED error will be returned.
|
|
*/
|
|
etag?: string;
|
|
/**
|
|
* Optional. Whether to cascade delete child instances for given cluster.
|
|
*/
|
|
force?: boolean;
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Cluster.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Export extends StandardParameters {
|
|
/**
|
|
* Required. The resource name of the cluster.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$ExportClusterRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Get extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Cluster.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. The view of the cluster to return. Returns all default fields if not set.
|
|
*/
|
|
view?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Import extends StandardParameters {
|
|
/**
|
|
* Required. The resource name of the cluster.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$ImportClusterRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$List extends StandardParameters {
|
|
/**
|
|
* Optional. Filtering results
|
|
*/
|
|
filter?: string;
|
|
/**
|
|
* Optional. Hint for how to order the results
|
|
*/
|
|
orderBy?: string;
|
|
/**
|
|
* Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
*/
|
|
pageSize?: number;
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
pageToken?: string;
|
|
/**
|
|
* Required. The name of the parent resource. For the required format, see the comment on the Cluster.name field. Additionally, you can perform an aggregated list operation by specifying a value with the following format: * projects/{project\}/locations/-
|
|
*/
|
|
parent?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Patch extends StandardParameters {
|
|
/**
|
|
* Optional. If set to true, update succeeds even if cluster is not found. In that case, a new cluster is created and `update_mask` is ignored.
|
|
*/
|
|
allowMissing?: boolean;
|
|
/**
|
|
* Output only. The name of the cluster resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\} where the cluster ID segment should satisfy the regex expression `[a-z0-9-]+`. For more details see https://google.aip.dev/122. The prefix of the cluster resource name is the name of the parent resource: * projects/{project\}/locations/{region\}
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. Field mask is used to specify the fields to be overwritten in the Cluster resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
*/
|
|
updateMask?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Cluster;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Promote extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Cluster.name field
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$PromoteClusterRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Restore extends StandardParameters {
|
|
/**
|
|
* Required. The name of the parent resource. For the required format, see the comment on the Cluster.name field.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$RestoreClusterRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Restorefromcloudsql extends StandardParameters {
|
|
/**
|
|
* Required. The location of the new cluster. For the required format, see the comment on Cluster.name field.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$RestoreFromCloudSQLRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Switchover extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Cluster.name field
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$SwitchoverClusterRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Upgrade extends StandardParameters {
|
|
/**
|
|
* Required. The resource name of the cluster.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$UpgradeClusterRequest;
|
|
}
|
|
export class Resource$Projects$Locations$Clusters$Instances {
|
|
context: APIRequestContext;
|
|
constructor(context: APIRequestContext);
|
|
/**
|
|
* Creates a new Instance in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.create({
|
|
* // Required. ID of the requesting object.
|
|
* instanceId: 'placeholder-value',
|
|
* // Required. The name of the parent resource. For the required format, see the comment on the Instance.name field.
|
|
* parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "activationPolicy": "my_activationPolicy",
|
|
* // "annotations": {},
|
|
* // "availabilityType": "my_availabilityType",
|
|
* // "clientConnectionConfig": {},
|
|
* // "connectionPoolConfig": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseFlags": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "etag": "my_etag",
|
|
* // "gceZone": "my_gceZone",
|
|
* // "instanceType": "my_instanceType",
|
|
* // "ipAddress": "my_ipAddress",
|
|
* // "labels": {},
|
|
* // "machineConfig": {},
|
|
* // "maintenanceVersionName": "my_maintenanceVersionName",
|
|
* // "name": "my_name",
|
|
* // "networkConfig": {},
|
|
* // "nodes": [],
|
|
* // "observabilityConfig": {},
|
|
* // "outboundPublicIpAddresses": [],
|
|
* // "pscInstanceConfig": {},
|
|
* // "publicIpAddress": "my_publicIpAddress",
|
|
* // "queryInsightsConfig": {},
|
|
* // "readPoolConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "state": "my_state",
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime",
|
|
* // "writableNode": {}
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Instances$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
create(params?: Params$Resource$Projects$Locations$Clusters$Instances$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Instances$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Instances$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Instances$Create, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
create(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Creates a new SECONDARY Instance in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res =
|
|
* await alloydb.projects.locations.clusters.instances.createsecondary({
|
|
* // Required. ID of the requesting object.
|
|
* instanceId: 'placeholder-value',
|
|
* // Required. The name of the parent resource. For the required format, see the comment on the Instance.name field.
|
|
* parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "activationPolicy": "my_activationPolicy",
|
|
* // "annotations": {},
|
|
* // "availabilityType": "my_availabilityType",
|
|
* // "clientConnectionConfig": {},
|
|
* // "connectionPoolConfig": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseFlags": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "etag": "my_etag",
|
|
* // "gceZone": "my_gceZone",
|
|
* // "instanceType": "my_instanceType",
|
|
* // "ipAddress": "my_ipAddress",
|
|
* // "labels": {},
|
|
* // "machineConfig": {},
|
|
* // "maintenanceVersionName": "my_maintenanceVersionName",
|
|
* // "name": "my_name",
|
|
* // "networkConfig": {},
|
|
* // "nodes": [],
|
|
* // "observabilityConfig": {},
|
|
* // "outboundPublicIpAddresses": [],
|
|
* // "pscInstanceConfig": {},
|
|
* // "publicIpAddress": "my_publicIpAddress",
|
|
* // "queryInsightsConfig": {},
|
|
* // "readPoolConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "state": "my_state",
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime",
|
|
* // "writableNode": {}
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Instances$Createsecondary, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
createsecondary(params?: Params$Resource$Projects$Locations$Clusters$Instances$Createsecondary, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Instances$Createsecondary, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Instances$Createsecondary, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
createsecondary(params: Params$Resource$Projects$Locations$Clusters$Instances$Createsecondary, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
createsecondary(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Deletes a single Instance.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.delete({
|
|
* // Optional. The current etag of the Instance. If an etag is provided and does not match the current etag of the Instance, deletion will be blocked and an ABORTED error will be returned.
|
|
* etag: 'placeholder-value',
|
|
* // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Instances$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
delete(params?: Params$Resource$Projects$Locations$Clusters$Instances$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Instances$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Instances$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Instances$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
delete(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Forces a Failover for a highly available instance. Failover promotes the HA standby instance as the new primary. Imperative only.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.failover({
|
|
* // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "requestId": "my_requestId",
|
|
* // "validateOnly": false
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
failover(params: Params$Resource$Projects$Locations$Clusters$Instances$Failover, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
failover(params?: Params$Resource$Projects$Locations$Clusters$Instances$Failover, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
failover(params: Params$Resource$Projects$Locations$Clusters$Instances$Failover, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
failover(params: Params$Resource$Projects$Locations$Clusters$Instances$Failover, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
failover(params: Params$Resource$Projects$Locations$Clusters$Instances$Failover, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
failover(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Gets details of a single Instance.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.get({
|
|
* // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
|
|
* // The view of the instance to return.
|
|
* view: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "activationPolicy": "my_activationPolicy",
|
|
* // "annotations": {},
|
|
* // "availabilityType": "my_availabilityType",
|
|
* // "clientConnectionConfig": {},
|
|
* // "connectionPoolConfig": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseFlags": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "etag": "my_etag",
|
|
* // "gceZone": "my_gceZone",
|
|
* // "instanceType": "my_instanceType",
|
|
* // "ipAddress": "my_ipAddress",
|
|
* // "labels": {},
|
|
* // "machineConfig": {},
|
|
* // "maintenanceVersionName": "my_maintenanceVersionName",
|
|
* // "name": "my_name",
|
|
* // "networkConfig": {},
|
|
* // "nodes": [],
|
|
* // "observabilityConfig": {},
|
|
* // "outboundPublicIpAddresses": [],
|
|
* // "pscInstanceConfig": {},
|
|
* // "publicIpAddress": "my_publicIpAddress",
|
|
* // "queryInsightsConfig": {},
|
|
* // "readPoolConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "state": "my_state",
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime",
|
|
* // "writableNode": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Instances$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
get(params?: Params$Resource$Projects$Locations$Clusters$Instances$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Instance>>;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Instances$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Instances$Get, options: MethodOptions | BodyResponseCallback<Schema$Instance>, callback: BodyResponseCallback<Schema$Instance>): void;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Instances$Get, callback: BodyResponseCallback<Schema$Instance>): void;
|
|
get(callback: BodyResponseCallback<Schema$Instance>): void;
|
|
/**
|
|
* Get instance metadata used for a connection.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res =
|
|
* await alloydb.projects.locations.clusters.instances.getConnectionInfo({
|
|
* // Required. The name of the parent resource. The required format is: projects/{project\}/locations/{location\}/clusters/{cluster\}/instances/{instance\}
|
|
* parent:
|
|
* 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "instanceUid": "my_instanceUid",
|
|
* // "ipAddress": "my_ipAddress",
|
|
* // "name": "my_name",
|
|
* // "publicIpAddress": "my_publicIpAddress"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
getConnectionInfo(params: Params$Resource$Projects$Locations$Clusters$Instances$Getconnectioninfo, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
getConnectionInfo(params?: Params$Resource$Projects$Locations$Clusters$Instances$Getconnectioninfo, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ConnectionInfo>>;
|
|
getConnectionInfo(params: Params$Resource$Projects$Locations$Clusters$Instances$Getconnectioninfo, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
getConnectionInfo(params: Params$Resource$Projects$Locations$Clusters$Instances$Getconnectioninfo, options: MethodOptions | BodyResponseCallback<Schema$ConnectionInfo>, callback: BodyResponseCallback<Schema$ConnectionInfo>): void;
|
|
getConnectionInfo(params: Params$Resource$Projects$Locations$Clusters$Instances$Getconnectioninfo, callback: BodyResponseCallback<Schema$ConnectionInfo>): void;
|
|
getConnectionInfo(callback: BodyResponseCallback<Schema$ConnectionInfo>): void;
|
|
/**
|
|
* Injects fault in an instance. Imperative only.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.injectFault({
|
|
* // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "faultType": "my_faultType",
|
|
* // "requestId": "my_requestId",
|
|
* // "validateOnly": false
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
injectFault(params: Params$Resource$Projects$Locations$Clusters$Instances$Injectfault, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
injectFault(params?: Params$Resource$Projects$Locations$Clusters$Instances$Injectfault, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
injectFault(params: Params$Resource$Projects$Locations$Clusters$Instances$Injectfault, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
injectFault(params: Params$Resource$Projects$Locations$Clusters$Instances$Injectfault, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
injectFault(params: Params$Resource$Projects$Locations$Clusters$Instances$Injectfault, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
injectFault(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Lists Instances in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.list({
|
|
* // Optional. Filtering results
|
|
* filter: 'placeholder-value',
|
|
* // Optional. Hint for how to order the results
|
|
* orderBy: 'placeholder-value',
|
|
* // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
* pageSize: 'placeholder-value',
|
|
* // A token identifying a page of results the server should return.
|
|
* pageToken: 'placeholder-value',
|
|
* // Required. The name of the parent resource. For the required format, see the comment on the Instance.name field. Additionally, you can perform an aggregated list operation by specifying a value with one of the following formats: * projects/{project\}/locations/-/clusters/- * projects/{project\}/locations/{region\}/clusters/-
|
|
* parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "instances": [],
|
|
* // "nextPageToken": "my_nextPageToken",
|
|
* // "unreachable": []
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Instances$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
list(params?: Params$Resource$Projects$Locations$Clusters$Instances$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListInstancesResponse>>;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Instances$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Instances$List, options: MethodOptions | BodyResponseCallback<Schema$ListInstancesResponse>, callback: BodyResponseCallback<Schema$ListInstancesResponse>): void;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Instances$List, callback: BodyResponseCallback<Schema$ListInstancesResponse>): void;
|
|
list(callback: BodyResponseCallback<Schema$ListInstancesResponse>): void;
|
|
/**
|
|
* Updates the parameters of a single Instance.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.patch({
|
|
* // Optional. If set to true, update succeeds even if instance is not found. In that case, a new instance is created and `update_mask` is ignored.
|
|
* allowMissing: 'placeholder-value',
|
|
* // Output only. The name of the instance resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}/instances/{instance_id\} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. Field mask is used to specify the fields to be overwritten in the Instance resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
* updateMask: 'placeholder-value',
|
|
* // Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "activationPolicy": "my_activationPolicy",
|
|
* // "annotations": {},
|
|
* // "availabilityType": "my_availabilityType",
|
|
* // "clientConnectionConfig": {},
|
|
* // "connectionPoolConfig": {},
|
|
* // "createTime": "my_createTime",
|
|
* // "databaseFlags": {},
|
|
* // "deleteTime": "my_deleteTime",
|
|
* // "displayName": "my_displayName",
|
|
* // "etag": "my_etag",
|
|
* // "gceZone": "my_gceZone",
|
|
* // "instanceType": "my_instanceType",
|
|
* // "ipAddress": "my_ipAddress",
|
|
* // "labels": {},
|
|
* // "machineConfig": {},
|
|
* // "maintenanceVersionName": "my_maintenanceVersionName",
|
|
* // "name": "my_name",
|
|
* // "networkConfig": {},
|
|
* // "nodes": [],
|
|
* // "observabilityConfig": {},
|
|
* // "outboundPublicIpAddresses": [],
|
|
* // "pscInstanceConfig": {},
|
|
* // "publicIpAddress": "my_publicIpAddress",
|
|
* // "queryInsightsConfig": {},
|
|
* // "readPoolConfig": {},
|
|
* // "reconciling": false,
|
|
* // "satisfiesPzs": false,
|
|
* // "state": "my_state",
|
|
* // "uid": "my_uid",
|
|
* // "updateTime": "my_updateTime",
|
|
* // "writableNode": {}
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Instances$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
patch(params?: Params$Resource$Projects$Locations$Clusters$Instances$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Instances$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Instances$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Instances$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
patch(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Restart an Instance in a cluster. Imperative only.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.instances.restart({
|
|
* // Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/instances/my-instance',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "nodeIds": [],
|
|
* // "requestId": "my_requestId",
|
|
* // "validateOnly": false
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
restart(params: Params$Resource$Projects$Locations$Clusters$Instances$Restart, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
restart(params?: Params$Resource$Projects$Locations$Clusters$Instances$Restart, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
restart(params: Params$Resource$Projects$Locations$Clusters$Instances$Restart, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
restart(params: Params$Resource$Projects$Locations$Clusters$Instances$Restart, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
restart(params: Params$Resource$Projects$Locations$Clusters$Instances$Restart, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
restart(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Create extends StandardParameters {
|
|
/**
|
|
* Required. ID of the requesting object.
|
|
*/
|
|
instanceId?: string;
|
|
/**
|
|
* Required. The name of the parent resource. For the required format, see the comment on the Instance.name field.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Instance;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Createsecondary extends StandardParameters {
|
|
/**
|
|
* Required. ID of the requesting object.
|
|
*/
|
|
instanceId?: string;
|
|
/**
|
|
* Required. The name of the parent resource. For the required format, see the comment on the Instance.name field.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Instance;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Delete extends StandardParameters {
|
|
/**
|
|
* Optional. The current etag of the Instance. If an etag is provided and does not match the current etag of the Instance, deletion will be blocked and an ABORTED error will be returned.
|
|
*/
|
|
etag?: string;
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Failover extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$FailoverInstanceRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Get extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* The view of the instance to return.
|
|
*/
|
|
view?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Getconnectioninfo extends StandardParameters {
|
|
/**
|
|
* Required. The name of the parent resource. The required format is: projects/{project\}/locations/{location\}/clusters/{cluster\}/instances/{instance\}
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Injectfault extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$InjectFaultRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$List extends StandardParameters {
|
|
/**
|
|
* Optional. Filtering results
|
|
*/
|
|
filter?: string;
|
|
/**
|
|
* Optional. Hint for how to order the results
|
|
*/
|
|
orderBy?: string;
|
|
/**
|
|
* Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
*/
|
|
pageSize?: number;
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
pageToken?: string;
|
|
/**
|
|
* Required. The name of the parent resource. For the required format, see the comment on the Instance.name field. Additionally, you can perform an aggregated list operation by specifying a value with one of the following formats: * projects/{project\}/locations/-/clusters/- * projects/{project\}/locations/{region\}/clusters/-
|
|
*/
|
|
parent?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Patch extends StandardParameters {
|
|
/**
|
|
* Optional. If set to true, update succeeds even if instance is not found. In that case, a new instance is created and `update_mask` is ignored.
|
|
*/
|
|
allowMissing?: boolean;
|
|
/**
|
|
* Output only. The name of the instance resource with the format: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}/instances/{instance_id\} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project\}/locations/{region\}/clusters/{cluster_id\}
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. Field mask is used to specify the fields to be overwritten in the Instance resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
*/
|
|
updateMask?: string;
|
|
/**
|
|
* Optional. If set, performs request validation, for example, permission checks and any other type of validation, but does not actually execute the create request.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$Instance;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Instances$Restart extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the Instance.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$RestartInstanceRequest;
|
|
}
|
|
export class Resource$Projects$Locations$Clusters$Users {
|
|
context: APIRequestContext;
|
|
constructor(context: APIRequestContext);
|
|
/**
|
|
* Creates a new User in a given project, location, and cluster.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.users.create({
|
|
* // Required. Value for parent.
|
|
* parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Required. ID of the requesting object.
|
|
* userId: 'placeholder-value',
|
|
* // Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "databaseRoles": [],
|
|
* // "keepExtraRoles": false,
|
|
* // "name": "my_name",
|
|
* // "password": "my_password",
|
|
* // "userType": "my_userType"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "databaseRoles": [],
|
|
* // "keepExtraRoles": false,
|
|
* // "name": "my_name",
|
|
* // "password": "my_password",
|
|
* // "userType": "my_userType"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Users$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
create(params?: Params$Resource$Projects$Locations$Clusters$Users$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$User>>;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Users$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Users$Create, options: MethodOptions | BodyResponseCallback<Schema$User>, callback: BodyResponseCallback<Schema$User>): void;
|
|
create(params: Params$Resource$Projects$Locations$Clusters$Users$Create, callback: BodyResponseCallback<Schema$User>): void;
|
|
create(callback: BodyResponseCallback<Schema$User>): void;
|
|
/**
|
|
* Deletes a single User.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.users.delete({
|
|
* // Required. The name of the resource. For the required format, see the comment on the User.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/users/my-user',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
* validateOnly: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {}
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Users$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
delete(params?: Params$Resource$Projects$Locations$Clusters$Users$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Empty>>;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Users$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Users$Delete, options: MethodOptions | BodyResponseCallback<Schema$Empty>, callback: BodyResponseCallback<Schema$Empty>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Clusters$Users$Delete, callback: BodyResponseCallback<Schema$Empty>): void;
|
|
delete(callback: BodyResponseCallback<Schema$Empty>): void;
|
|
/**
|
|
* Gets details of a single User.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.users.get({
|
|
* // Required. The name of the resource. For the required format, see the comment on the User.name field.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/users/my-user',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "databaseRoles": [],
|
|
* // "keepExtraRoles": false,
|
|
* // "name": "my_name",
|
|
* // "password": "my_password",
|
|
* // "userType": "my_userType"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Users$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
get(params?: Params$Resource$Projects$Locations$Clusters$Users$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$User>>;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Users$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Users$Get, options: MethodOptions | BodyResponseCallback<Schema$User>, callback: BodyResponseCallback<Schema$User>): void;
|
|
get(params: Params$Resource$Projects$Locations$Clusters$Users$Get, callback: BodyResponseCallback<Schema$User>): void;
|
|
get(callback: BodyResponseCallback<Schema$User>): void;
|
|
/**
|
|
* Lists Users in a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.users.list({
|
|
* // Optional. Filtering results
|
|
* filter: 'placeholder-value',
|
|
* // Optional. Hint for how to order the results
|
|
* orderBy: 'placeholder-value',
|
|
* // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
* pageSize: 'placeholder-value',
|
|
* // Optional. A token identifying a page of results the server should return.
|
|
* pageToken: 'placeholder-value',
|
|
* // Required. Parent value for ListUsersRequest
|
|
* parent: 'projects/my-project/locations/my-location/clusters/my-cluster',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "nextPageToken": "my_nextPageToken",
|
|
* // "unreachable": [],
|
|
* // "users": []
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Users$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
list(params?: Params$Resource$Projects$Locations$Clusters$Users$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListUsersResponse>>;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Users$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Users$List, options: MethodOptions | BodyResponseCallback<Schema$ListUsersResponse>, callback: BodyResponseCallback<Schema$ListUsersResponse>): void;
|
|
list(params: Params$Resource$Projects$Locations$Clusters$Users$List, callback: BodyResponseCallback<Schema$ListUsersResponse>): void;
|
|
list(callback: BodyResponseCallback<Schema$ListUsersResponse>): void;
|
|
/**
|
|
* Updates the parameters of a single User.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.clusters.users.patch({
|
|
* // Optional. Allow missing fields in the update mask.
|
|
* allowMissing: 'placeholder-value',
|
|
* // Output only. Name of the resource in the form of projects/{project\}/locations/{location\}/cluster/{cluster\}/users/{user\}.
|
|
* name: 'projects/my-project/locations/my-location/clusters/my-cluster/users/my-user',
|
|
* // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
* requestId: 'placeholder-value',
|
|
* // Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
* updateMask: 'placeholder-value',
|
|
* // Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
* validateOnly: 'placeholder-value',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {
|
|
* // "databaseRoles": [],
|
|
* // "keepExtraRoles": false,
|
|
* // "name": "my_name",
|
|
* // "password": "my_password",
|
|
* // "userType": "my_userType"
|
|
* // }
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "databaseRoles": [],
|
|
* // "keepExtraRoles": false,
|
|
* // "name": "my_name",
|
|
* // "password": "my_password",
|
|
* // "userType": "my_userType"
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Users$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
patch(params?: Params$Resource$Projects$Locations$Clusters$Users$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$User>>;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Users$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Users$Patch, options: MethodOptions | BodyResponseCallback<Schema$User>, callback: BodyResponseCallback<Schema$User>): void;
|
|
patch(params: Params$Resource$Projects$Locations$Clusters$Users$Patch, callback: BodyResponseCallback<Schema$User>): void;
|
|
patch(callback: BodyResponseCallback<Schema$User>): void;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Users$Create extends StandardParameters {
|
|
/**
|
|
* Required. Value for parent.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Required. ID of the requesting object.
|
|
*/
|
|
userId?: string;
|
|
/**
|
|
* Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$User;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Users$Delete extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the User.name field.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
*/
|
|
validateOnly?: boolean;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Users$Get extends StandardParameters {
|
|
/**
|
|
* Required. The name of the resource. For the required format, see the comment on the User.name field.
|
|
*/
|
|
name?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Users$List extends StandardParameters {
|
|
/**
|
|
* Optional. Filtering results
|
|
*/
|
|
filter?: string;
|
|
/**
|
|
* Optional. Hint for how to order the results
|
|
*/
|
|
orderBy?: string;
|
|
/**
|
|
* Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
*/
|
|
pageSize?: number;
|
|
/**
|
|
* Optional. A token identifying a page of results the server should return.
|
|
*/
|
|
pageToken?: string;
|
|
/**
|
|
* Required. Parent value for ListUsersRequest
|
|
*/
|
|
parent?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Clusters$Users$Patch extends StandardParameters {
|
|
/**
|
|
* Optional. Allow missing fields in the update mask.
|
|
*/
|
|
allowMissing?: boolean;
|
|
/**
|
|
* Output only. Name of the resource in the form of projects/{project\}/locations/{location\}/cluster/{cluster\}/users/{user\}.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server ignores the request if it has already been completed. The server guarantees that for at least 60 minutes since 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 the original operation with the same request ID was received, and if so, ignores 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).
|
|
*/
|
|
requestId?: string;
|
|
/**
|
|
* Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
|
|
*/
|
|
updateMask?: string;
|
|
/**
|
|
* Optional. If set, the backend validates the request, but doesn't actually execute it.
|
|
*/
|
|
validateOnly?: boolean;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$User;
|
|
}
|
|
export class Resource$Projects$Locations$Operations {
|
|
context: APIRequestContext;
|
|
constructor(context: APIRequestContext);
|
|
/**
|
|
* Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.operations.cancel({
|
|
* // The name of the operation resource to be cancelled.
|
|
* name: 'projects/my-project/locations/my-location/operations/my-operation',
|
|
*
|
|
* // Request body metadata
|
|
* requestBody: {
|
|
* // request body parameters
|
|
* // {}
|
|
* },
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {}
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
cancel(params: Params$Resource$Projects$Locations$Operations$Cancel, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
cancel(params?: Params$Resource$Projects$Locations$Operations$Cancel, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Empty>>;
|
|
cancel(params: Params$Resource$Projects$Locations$Operations$Cancel, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
cancel(params: Params$Resource$Projects$Locations$Operations$Cancel, options: MethodOptions | BodyResponseCallback<Schema$Empty>, callback: BodyResponseCallback<Schema$Empty>): void;
|
|
cancel(params: Params$Resource$Projects$Locations$Operations$Cancel, callback: BodyResponseCallback<Schema$Empty>): void;
|
|
cancel(callback: BodyResponseCallback<Schema$Empty>): void;
|
|
/**
|
|
* 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`.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.operations.delete({
|
|
* // The name of the operation resource to be deleted.
|
|
* name: 'projects/my-project/locations/my-location/operations/my-operation',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {}
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
delete(params: Params$Resource$Projects$Locations$Operations$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
delete(params?: Params$Resource$Projects$Locations$Operations$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Empty>>;
|
|
delete(params: Params$Resource$Projects$Locations$Operations$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Operations$Delete, options: MethodOptions | BodyResponseCallback<Schema$Empty>, callback: BodyResponseCallback<Schema$Empty>): void;
|
|
delete(params: Params$Resource$Projects$Locations$Operations$Delete, callback: BodyResponseCallback<Schema$Empty>): void;
|
|
delete(callback: BodyResponseCallback<Schema$Empty>): void;
|
|
/**
|
|
* Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.operations.get({
|
|
* // The name of the operation resource.
|
|
* name: 'projects/my-project/locations/my-location/operations/my-operation',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "done": false,
|
|
* // "error": {},
|
|
* // "metadata": {},
|
|
* // "name": "my_name",
|
|
* // "response": {}
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
get(params: Params$Resource$Projects$Locations$Operations$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
get(params?: Params$Resource$Projects$Locations$Operations$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
|
|
get(params: Params$Resource$Projects$Locations$Operations$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
get(params: Params$Resource$Projects$Locations$Operations$Get, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
get(params: Params$Resource$Projects$Locations$Operations$Get, callback: BodyResponseCallback<Schema$Operation>): void;
|
|
get(callback: BodyResponseCallback<Schema$Operation>): void;
|
|
/**
|
|
* Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.operations.list({
|
|
* // The standard list filter.
|
|
* filter: 'placeholder-value',
|
|
* // The name of the operation's parent resource.
|
|
* name: 'projects/my-project/locations/my-location',
|
|
* // The standard list page size.
|
|
* pageSize: 'placeholder-value',
|
|
* // The standard list page token.
|
|
* pageToken: 'placeholder-value',
|
|
* // 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.
|
|
* returnPartialSuccess: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "nextPageToken": "my_nextPageToken",
|
|
* // "operations": [],
|
|
* // "unreachable": []
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
list(params: Params$Resource$Projects$Locations$Operations$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
list(params?: Params$Resource$Projects$Locations$Operations$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListOperationsResponse>>;
|
|
list(params: Params$Resource$Projects$Locations$Operations$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
list(params: Params$Resource$Projects$Locations$Operations$List, options: MethodOptions | BodyResponseCallback<Schema$ListOperationsResponse>, callback: BodyResponseCallback<Schema$ListOperationsResponse>): void;
|
|
list(params: Params$Resource$Projects$Locations$Operations$List, callback: BodyResponseCallback<Schema$ListOperationsResponse>): void;
|
|
list(callback: BodyResponseCallback<Schema$ListOperationsResponse>): void;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Operations$Cancel extends StandardParameters {
|
|
/**
|
|
* The name of the operation resource to be cancelled.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Request body metadata
|
|
*/
|
|
requestBody?: Schema$CancelOperationRequest;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Operations$Delete extends StandardParameters {
|
|
/**
|
|
* The name of the operation resource to be deleted.
|
|
*/
|
|
name?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Operations$Get extends StandardParameters {
|
|
/**
|
|
* The name of the operation resource.
|
|
*/
|
|
name?: string;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Operations$List extends StandardParameters {
|
|
/**
|
|
* The standard list filter.
|
|
*/
|
|
filter?: string;
|
|
/**
|
|
* The name of the operation's parent resource.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* The standard list page size.
|
|
*/
|
|
pageSize?: number;
|
|
/**
|
|
* The standard list page token.
|
|
*/
|
|
pageToken?: string;
|
|
/**
|
|
* 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.
|
|
*/
|
|
returnPartialSuccess?: boolean;
|
|
}
|
|
export class Resource$Projects$Locations$Supporteddatabaseflags {
|
|
context: APIRequestContext;
|
|
constructor(context: APIRequestContext);
|
|
/**
|
|
* Lists SupportedDatabaseFlags for a given project and location.
|
|
* @example
|
|
* ```js
|
|
* // Before running the sample:
|
|
* // - Enable the API at:
|
|
* // https://console.developers.google.com/apis/api/alloydb.googleapis.com
|
|
* // - Login into gcloud by running:
|
|
* // ```sh
|
|
* // $ gcloud auth application-default login
|
|
* // ```
|
|
* // - Install the npm module by running:
|
|
* // ```sh
|
|
* // $ npm install googleapis
|
|
* // ```
|
|
*
|
|
* const {google} = require('googleapis');
|
|
* const alloydb = google.alloydb('v1');
|
|
*
|
|
* async function main() {
|
|
* const auth = new google.auth.GoogleAuth({
|
|
* // Scopes can be specified either as an array or as a single, space-delimited string.
|
|
* scopes: ['https://www.googleapis.com/auth/cloud-platform'],
|
|
* });
|
|
*
|
|
* // Acquire an auth client, and bind it to all future calls
|
|
* const authClient = await auth.getClient();
|
|
* google.options({auth: authClient});
|
|
*
|
|
* // Do the magic
|
|
* const res = await alloydb.projects.locations.supportedDatabaseFlags.list({
|
|
* // Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
* pageSize: 'placeholder-value',
|
|
* // A token identifying a page of results the server should return.
|
|
* pageToken: 'placeholder-value',
|
|
* // Required. The name of the parent resource. The required format is: * projects/{project\}/locations/{location\} Regardless of the parent specified here, as long it is contains a valid project and location, the service will return a static list of supported flags resources. Note that we do not yet support region-specific flags.
|
|
* parent: 'projects/my-project/locations/my-location',
|
|
* // Optional. The scope for which supported flags are requested. If not specified, default is DATABASE.
|
|
* scope: 'placeholder-value',
|
|
* });
|
|
* console.log(res.data);
|
|
*
|
|
* // Example response
|
|
* // {
|
|
* // "nextPageToken": "my_nextPageToken",
|
|
* // "supportedDatabaseFlags": []
|
|
* // }
|
|
* }
|
|
*
|
|
* main().catch(e => {
|
|
* console.error(e);
|
|
* throw e;
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @param params - Parameters for request
|
|
* @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
|
|
* @param callback - Optional callback that handles the response.
|
|
* @returns A promise if used with async/await, or void if used with a callback.
|
|
*/
|
|
list(params: Params$Resource$Projects$Locations$Supporteddatabaseflags$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
|
|
list(params?: Params$Resource$Projects$Locations$Supporteddatabaseflags$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListSupportedDatabaseFlagsResponse>>;
|
|
list(params: Params$Resource$Projects$Locations$Supporteddatabaseflags$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
|
|
list(params: Params$Resource$Projects$Locations$Supporteddatabaseflags$List, options: MethodOptions | BodyResponseCallback<Schema$ListSupportedDatabaseFlagsResponse>, callback: BodyResponseCallback<Schema$ListSupportedDatabaseFlagsResponse>): void;
|
|
list(params: Params$Resource$Projects$Locations$Supporteddatabaseflags$List, callback: BodyResponseCallback<Schema$ListSupportedDatabaseFlagsResponse>): void;
|
|
list(callback: BodyResponseCallback<Schema$ListSupportedDatabaseFlagsResponse>): void;
|
|
}
|
|
export interface Params$Resource$Projects$Locations$Supporteddatabaseflags$List extends StandardParameters {
|
|
/**
|
|
* Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
|
|
*/
|
|
pageSize?: number;
|
|
/**
|
|
* A token identifying a page of results the server should return.
|
|
*/
|
|
pageToken?: string;
|
|
/**
|
|
* Required. The name of the parent resource. The required format is: * projects/{project\}/locations/{location\} Regardless of the parent specified here, as long it is contains a valid project and location, the service will return a static list of supported flags resources. Note that we do not yet support region-specific flags.
|
|
*/
|
|
parent?: string;
|
|
/**
|
|
* Optional. The scope for which supported flags are requested. If not specified, default is DATABASE.
|
|
*/
|
|
scope?: string;
|
|
}
|
|
export {};
|
|
}
|