Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions packages/google-cloud-sql/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,6 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ

| Sample | Source Code |
| --------------------------- | --------------------------------- |
| cloud | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/snippet_metadata_google.cloud.sql.v1.json) |
| delete | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_backup_runs_service.delete.js) |
| get | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_backup_runs_service.get.js) |
| insert | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_backup_runs_service.insert.js) |
Expand All @@ -70,6 +69,7 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
| update backup | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_backups_service.update_backup.js) |
| generate ephemeral cert | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_connect_service.generate_ephemeral_cert.js) |
| get connect settings | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_connect_service.get_connect_settings.js) |
| resolve connect settings | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_connect_service.resolve_connect_settings.js) |
| delete | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_databases_service.delete.js) |
| get | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_databases_service.get.js) |
| insert | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_databases_service.insert.js) |
Expand Down Expand Up @@ -133,7 +133,6 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
| insert | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_users_service.insert.js) |
| list | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_users_service.list.js) |
| update | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1/sql_users_service.update.js) |
| cloud | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/snippet_metadata_google.cloud.sql.v1beta4.json) |
| delete | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_backup_runs_service.delete.js) |
| get | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_backup_runs_service.get.js) |
| insert | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_backup_runs_service.insert.js) |
Expand All @@ -145,6 +144,8 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
| update backup | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_backups_service.update_backup.js) |
| generate ephemeral cert | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_connect_service.generate_ephemeral_cert.js) |
| get connect settings | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_connect_service.get_connect_settings.js) |
| resolve connect settings | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_connect_service.resolve_connect_settings.js) |
| stream sql data | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_data_service.stream_sql_data.js) |
| delete | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_databases_service.delete.js) |
| get | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_databases_service.get.js) |
| insert | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/samples/generated/v1beta4/sql_databases_service.insert.js) |
Expand Down Expand Up @@ -241,7 +242,7 @@ More Information: [Google Cloud Platform Launch Stages][launch_stages]

## Contributing

Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/CONTRIBUTING.md).
Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).

Please note that this `README.md`
and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
Expand All @@ -251,7 +252,7 @@ are generated from a central template.

Apache Version 2.0

See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-sql/LICENSE)
See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)

[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
[projects]: https://console.cloud.google.com/project
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,15 @@ service SqlConnectService {
};
}

// Retrieves connect settings about a Cloud SQL instance using the instance
// DNS name.
rpc ResolveConnectSettings(ResolveConnectSettingsRequest)
returns (ConnectSettings) {
option (google.api.http) = {
get: "/v1/locations/{location}/dns/{dns_name}:resolveConnectSettings"
};
}

// Generates a short-lived X509 certificate containing the provided public key
// and signed by a private key specific to the target instance. Users may use
// the certificate to authenticate as themselves when connecting to the
Expand Down Expand Up @@ -69,6 +78,15 @@ message GetConnectSettingsRequest {
[(google.api.field_behavior) = OPTIONAL];
}

// Connect settings retrieval request.
message ResolveConnectSettingsRequest {
// Required. Cloud SQL instance ID. This does not include the project ID.
string dns_name = 1 [(google.api.field_behavior) = REQUIRED];

// Required. The region of the instance.
string location = 2 [(google.api.field_behavior) = REQUIRED];
}

// Connect settings retrieval response.
message ConnectSettings {
// Various Certificate Authority (CA) modes for certificate signing.
Expand Down Expand Up @@ -182,6 +200,13 @@ message ConnectSettings {
(google.api.field_behavior) = OUTPUT_ONLY,
(google.api.field_behavior) = OPTIONAL
];

// Optional. Output only. Connection name of the Cloud SQL instance used in
// connection strings, in the format project:region:instance.
string connection_name = 40 [
(google.api.field_behavior) = OUTPUT_ONLY,
(google.api.field_behavior) = OPTIONAL
];
}

// Ephemeral certificate creation request.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -481,7 +481,7 @@ message SqlInstancesCloneRequest {
// not include the project ID.
string instance = 1 [(google.api.field_behavior) = REQUIRED];

// Required. Project ID of the source as well as the clone Cloud SQL instance.
// Required. Project ID of the source Cloud SQL instance.
string project = 2 [(google.api.field_behavior) = REQUIRED];

InstancesCloneRequest body = 100 [(google.api.field_behavior) = REQUIRED];
Expand Down Expand Up @@ -648,6 +648,16 @@ message SqlInstancesPatchRequest {
// Project ID of the project that contains the instance.
string project = 2;

// Optional. Set PSC config to the same value as the existing config to
// reconcile the PSC networking.
optional bool reconcile_psc_networking = 4
[(google.api.field_behavior) = OPTIONAL];

// Optional. Set PSC config to the same value as the existing config and force
// reconcile the PSC networking.
optional bool reconcile_psc_networking_force = 5
[(google.api.field_behavior) = OPTIONAL];

DatabaseInstance body = 100;
}

Expand Down Expand Up @@ -1317,7 +1327,7 @@ message CloneContext {
[(google.api.field_behavior) = OPTIONAL];

// Optional. The fully qualified URI of the VPC network to which the cloned
// instance will be connected via Private Services Access for private IP. For
// instance will be connected via private services access for private IP. For
// example:`projects/my-network-project/global/networks/my-network`. This
// field is only required for cross-project cloning.
optional string destination_network = 14 [
Expand Down Expand Up @@ -1366,6 +1376,20 @@ message PointInTimeRestoreContext {
// instance. This value cannot be the same as the preferred_zone field.
optional string preferred_secondary_zone = 9
[(google.api.field_behavior) = OPTIONAL];

// Optional. Specifies the instance settings that will be overridden from the
// source instance. This field is only applicable for cross project PITRs.
DatabaseInstance target_instance_settings = 11
[(google.api.field_behavior) = OPTIONAL];

// Optional. Specifies the instance settings that will be cleared from the
// source instance. This field is only applicable for cross project PITRs.
repeated string target_instance_clear_settings_field_names = 12
[(google.api.field_behavior) = OPTIONAL];

// Optional. The region of the target instance where the datasource will be
// restored. For example: "us-central1".
optional string region = 13 [(google.api.field_behavior) = OPTIONAL];
}

// Binary log coordinates.
Expand Down Expand Up @@ -2313,7 +2337,7 @@ message ExecuteSqlPayload {

// Credentials for the database connection.
oneof user_password {
// Optional. When set to true, the API caller identity associated with the
// Optional. When set to `true`, the API caller identity associated with the
// request is used for database authentication. The API caller must be an
// IAM user in the database.
bool auto_iam_authn = 11 [(google.api.field_behavior) = OPTIONAL];
Expand Down Expand Up @@ -2510,4 +2534,7 @@ enum SqlSuspensionReason {

// The KMS key used by the instance is either revoked or denied access to
KMS_KEY_ISSUE = 5;

// The project is suspended due to abuse detected by Ares.
PROJECT_ABUSE = 8;
}
Loading
Loading