|
785 | 785 | }, |
786 | 786 | "instances": { |
787 | 787 | "methods": { |
| 788 | + "ListEntraIdCertificates": { |
| 789 | + "description": "Lists all versions of EntraID certificates for the specified instance. There can be up to three sets of certificates listed: the certificate that is currently in use, a future that has been added but not yet used to sign a certificate, and a certificate that has been rotated out.", |
| 790 | + "flatPath": "v1/projects/{project}/instances/{instance}/listEntraIdCertificates", |
| 791 | + "httpMethod": "GET", |
| 792 | + "id": "sql.instances.ListEntraIdCertificates", |
| 793 | + "parameterOrder": [ |
| 794 | + "project", |
| 795 | + "instance" |
| 796 | + ], |
| 797 | + "parameters": { |
| 798 | + "instance": { |
| 799 | + "description": "Required. Cloud SQL instance ID. This does not include the project ID.", |
| 800 | + "location": "path", |
| 801 | + "required": true, |
| 802 | + "type": "string" |
| 803 | + }, |
| 804 | + "project": { |
| 805 | + "description": "Required. Project ID of the project that contains the instance.", |
| 806 | + "location": "path", |
| 807 | + "required": true, |
| 808 | + "type": "string" |
| 809 | + } |
| 810 | + }, |
| 811 | + "path": "v1/projects/{project}/instances/{instance}/listEntraIdCertificates", |
| 812 | + "response": { |
| 813 | + "$ref": "InstancesListEntraIdCertificatesResponse" |
| 814 | + }, |
| 815 | + "scopes": [ |
| 816 | + "https://www.googleapis.com/auth/cloud-platform", |
| 817 | + "https://www.googleapis.com/auth/sqlservice.admin" |
| 818 | + ] |
| 819 | + }, |
788 | 820 | "ListServerCertificates": { |
789 | 821 | "description": "Lists all versions of server certificates and certificate authorities (CAs) for the specified instance. There can be up to three sets of certs listed: the certificate that is currently in use, a future that has been added but not yet used to sign a certificate, and a certificate that has been rotated out. For instances not using Certificate Authority Service (CAS) server CA, use ListServerCas instead.", |
790 | 822 | "flatPath": "v1/projects/{project}/instances/{instance}/listServerCertificates", |
|
817 | 849 | "https://www.googleapis.com/auth/sqlservice.admin" |
818 | 850 | ] |
819 | 851 | }, |
| 852 | + "RotateEntraIdCertificate": { |
| 853 | + "description": "Rotates the server certificate version to one previously added with the addEntraIdCertificate method.", |
| 854 | + "flatPath": "v1/projects/{project}/instances/{instance}/rotateEntraIdCertificate", |
| 855 | + "httpMethod": "POST", |
| 856 | + "id": "sql.instances.RotateEntraIdCertificate", |
| 857 | + "parameterOrder": [ |
| 858 | + "project", |
| 859 | + "instance" |
| 860 | + ], |
| 861 | + "parameters": { |
| 862 | + "instance": { |
| 863 | + "description": "Required. Cloud SQL instance ID. This does not include the project ID.", |
| 864 | + "location": "path", |
| 865 | + "required": true, |
| 866 | + "type": "string" |
| 867 | + }, |
| 868 | + "project": { |
| 869 | + "description": "Required. Project ID of the project that contains the instance.", |
| 870 | + "location": "path", |
| 871 | + "required": true, |
| 872 | + "type": "string" |
| 873 | + } |
| 874 | + }, |
| 875 | + "path": "v1/projects/{project}/instances/{instance}/rotateEntraIdCertificate", |
| 876 | + "request": { |
| 877 | + "$ref": "InstancesRotateEntraIdCertificateRequest" |
| 878 | + }, |
| 879 | + "response": { |
| 880 | + "$ref": "Operation" |
| 881 | + }, |
| 882 | + "scopes": [ |
| 883 | + "https://www.googleapis.com/auth/cloud-platform", |
| 884 | + "https://www.googleapis.com/auth/sqlservice.admin" |
| 885 | + ] |
| 886 | + }, |
820 | 887 | "RotateServerCertificate": { |
821 | 888 | "description": "Rotates the server certificate version to one previously added with the addServerCertificate method. For instances not using Certificate Authority Service (CAS) server CA, use RotateServerCa instead.", |
822 | 889 | "flatPath": "v1/projects/{project}/instances/{instance}/rotateServerCertificate", |
|
2647 | 2714 | "instance" |
2648 | 2715 | ], |
2649 | 2716 | "parameters": { |
| 2717 | + "databaseRoles": { |
| 2718 | + "description": "Optional. List of database roles to grant to the user. body.database_roles will be ignored for update request.", |
| 2719 | + "location": "query", |
| 2720 | + "repeated": true, |
| 2721 | + "type": "string" |
| 2722 | + }, |
2650 | 2723 | "host": { |
2651 | 2724 | "description": "Optional. Host of the user in the instance.", |
2652 | 2725 | "location": "query", |
|
2685 | 2758 | } |
2686 | 2759 | } |
2687 | 2760 | }, |
2688 | | - "revision": "20251019", |
| 2761 | + "revision": "20251107", |
2689 | 2762 | "rootUrl": "https://sqladmin.googleapis.com/", |
2690 | 2763 | "schemas": { |
2691 | 2764 | "AclEntry": { |
|
4562 | 4635 | ], |
4563 | 4636 | "enumDescriptions": [ |
4564 | 4637 | "This is an unknown suspension reason.", |
4565 | | - "The instance is suspended due to billing issues (for example:, GCP account issue)", |
| 4638 | + "The instance is suspended due to billing issues (for example:, account issue)", |
4566 | 4639 | "The instance is suspended due to illegal content (for example:, child pornography, copyrighted material, etc.).", |
4567 | 4640 | "The instance is causing operational issues (for example:, causing the database to crash).", |
4568 | 4641 | "The KMS key used by the instance is either revoked or denied access to" |
|
5472 | 5545 | "type": "object" |
5473 | 5546 | }, |
5474 | 5547 | "noRecovery": { |
5475 | | - "description": "Whether or not the backup importing will restore database with NORECOVERY option Applies only to Cloud SQL for SQL Server.", |
| 5548 | + "description": "Whether or not the backup importing will restore database with NORECOVERY option. Applies only to Cloud SQL for SQL Server.", |
5476 | 5549 | "type": "boolean" |
5477 | 5550 | }, |
5478 | 5551 | "recoveryOnly": { |
|
5741 | 5814 | }, |
5742 | 5815 | "type": "object" |
5743 | 5816 | }, |
| 5817 | + "InstancesListEntraIdCertificatesResponse": { |
| 5818 | + "description": "Instances ListEntraIdCertificates response.", |
| 5819 | + "id": "InstancesListEntraIdCertificatesResponse", |
| 5820 | + "properties": { |
| 5821 | + "activeVersion": { |
| 5822 | + "description": "The `sha1_fingerprint` of the active certificate from `certs`.", |
| 5823 | + "type": "string" |
| 5824 | + }, |
| 5825 | + "certs": { |
| 5826 | + "description": "List of Entra ID certificates for the instance.", |
| 5827 | + "items": { |
| 5828 | + "$ref": "SslCert" |
| 5829 | + }, |
| 5830 | + "type": "array" |
| 5831 | + }, |
| 5832 | + "kind": { |
| 5833 | + "description": "This is always `sql#instancesListEntraIdCertificates`.", |
| 5834 | + "type": "string" |
| 5835 | + } |
| 5836 | + }, |
| 5837 | + "type": "object" |
| 5838 | + }, |
5744 | 5839 | "InstancesListResponse": { |
5745 | 5840 | "description": "Database instances list response.", |
5746 | 5841 | "id": "InstancesListResponse", |
|
5872 | 5967 | }, |
5873 | 5968 | "type": "object" |
5874 | 5969 | }, |
| 5970 | + "InstancesRotateEntraIdCertificateRequest": { |
| 5971 | + "description": "Rotate Entra ID certificate request.", |
| 5972 | + "id": "InstancesRotateEntraIdCertificateRequest", |
| 5973 | + "properties": { |
| 5974 | + "rotateEntraIdCertificateContext": { |
| 5975 | + "$ref": "RotateEntraIdCertificateContext", |
| 5976 | + "description": "Optional. Contains details about the rotate server certificate operation." |
| 5977 | + } |
| 5978 | + }, |
| 5979 | + "type": "object" |
| 5980 | + }, |
5875 | 5981 | "InstancesRotateServerCaRequest": { |
5876 | 5982 | "description": "Rotate server CA request.", |
5877 | 5983 | "id": "InstancesRotateServerCaRequest", |
|
5984 | 6090 | "description": "Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects/{PROJECT}/locations/{REGION}/caPools/{CA_POOL_ID}", |
5985 | 6091 | "type": "string" |
5986 | 6092 | }, |
| 6093 | + "serverCertificateRotationMode": { |
| 6094 | + "description": "Optional. Controls the automatic server certificate rotation feature. This feature is disabled by default. When enabled, the server certificate will be automatically rotated during Cloud SQL scheduled maintenance or self-service maintenance updates up to six months before it expires. This setting can only be set if server_ca_mode is either GOOGLE_MANAGED_CAS_CA or CUSTOMER_MANAGED_CAS_CA.", |
| 6095 | + "enum": [ |
| 6096 | + "SERVER_CERTIFICATE_ROTATION_MODE_UNSPECIFIED", |
| 6097 | + "NO_AUTOMATIC_ROTATION", |
| 6098 | + "AUTOMATIC_ROTATION_DURING_MAINTENANCE" |
| 6099 | + ], |
| 6100 | + "enumDescriptions": [ |
| 6101 | + "Unspecified: no automatic server certificate rotation.", |
| 6102 | + "No automatic server certificate rotation. The user must [manage server certificate rotation](/sql/docs/mysql/manage-ssl-instance#rotate-server-certificate-cas) on their side.", |
| 6103 | + "Automatic server certificate rotation during Cloud SQL scheduled maintenance or self-service maintenance updates. Requires `server_ca_mode` to be `GOOGLE_MANAGED_CAS_CA` or `CUSTOMER_MANAGED_CAS_CA`." |
| 6104 | + ], |
| 6105 | + "type": "string" |
| 6106 | + }, |
5987 | 6107 | "sslMode": { |
5988 | 6108 | "description": "Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.", |
5989 | 6109 | "enum": [ |
|
6725 | 6845 | "type": "object" |
6726 | 6846 | }, |
6727 | 6847 | "PointInTimeRestoreContext": { |
6728 | | - "description": "The context to perform a point-in-time recovery of an instance managed by Google Cloud Backup and Disaster Recovery.", |
| 6848 | + "description": "The context to perform a point-in-time recovery of an instance managed by Backup and Disaster Recovery (DR) Service.", |
6729 | 6849 | "id": "PointInTimeRestoreContext", |
6730 | 6850 | "properties": { |
6731 | 6851 | "allocatedIpRange": { |
6732 | 6852 | "description": "Optional. The name of the allocated IP range for the internal IP Cloud SQL instance. For example: \"google-managed-services-default\". If you set this, then Cloud SQL creates the IP address for the cloned instance in the allocated range. This range must comply with [RFC 1035](https://tools.ietf.org/html/rfc1035) standards. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Reserved for future use.", |
6733 | 6853 | "type": "string" |
6734 | 6854 | }, |
6735 | 6855 | "datasource": { |
6736 | | - "description": "The Google Cloud Backup and Disaster Recovery Datasource URI. Format: projects/{project}/locations/{region}/backupVaults/{backupvault}/dataSources/{datasource}.", |
| 6856 | + "description": "The Backup and Disaster Recovery (DR) Service Datasource URI. Format: projects/{project}/locations/{region}/backupVaults/{backupvault}/dataSources/{datasource}.", |
6737 | 6857 | "type": "string" |
6738 | 6858 | }, |
6739 | 6859 | "pointInTime": { |
|
7275 | 7395 | }, |
7276 | 7396 | "type": "object" |
7277 | 7397 | }, |
| 7398 | + "RotateEntraIdCertificateContext": { |
| 7399 | + "description": "Instance rotate Entra ID certificate context.", |
| 7400 | + "id": "RotateEntraIdCertificateContext", |
| 7401 | + "properties": { |
| 7402 | + "kind": { |
| 7403 | + "description": "Optional. This is always `sql#rotateEntraIdCertificateContext`.", |
| 7404 | + "type": "string" |
| 7405 | + }, |
| 7406 | + "nextVersion": { |
| 7407 | + "description": "Optional. The fingerprint of the next version to be rotated to. If left unspecified, will be rotated to the most recently added server certificate version.", |
| 7408 | + "type": "string" |
| 7409 | + } |
| 7410 | + }, |
| 7411 | + "type": "object" |
| 7412 | + }, |
7278 | 7413 | "RotateServerCaContext": { |
7279 | 7414 | "description": "Instance rotate server CA context.", |
7280 | 7415 | "id": "RotateServerCaContext", |
|
7422 | 7557 | "type": "boolean" |
7423 | 7558 | }, |
7424 | 7559 | "dataApiAccess": { |
7425 | | - "description": "This parameter controls whether to allow using Data API to connect to the instance. Not allowed by default.", |
| 7560 | + "description": "This parameter controls whether to allow using ExecuteSql API to connect to the instance. Not allowed by default.", |
7426 | 7561 | "enum": [ |
7427 | 7562 | "DATA_API_ACCESS_UNSPECIFIED", |
7428 | 7563 | "DISALLOW_DATA_API", |
7429 | 7564 | "ALLOW_DATA_API" |
7430 | 7565 | ], |
7431 | 7566 | "enumDescriptions": [ |
7432 | 7567 | "Unspecified, effectively the same as `DISALLOW_DATA_API`.", |
7433 | | - "Disallow using Data API to connect to the instance.", |
7434 | | - "Allow using Data API to connect to the instance. For private IP instances, this will allow authorized users to access the instance from the public internet." |
| 7568 | + "Disallow using ExecuteSql API to connect to the instance.", |
| 7569 | + "Allow using ExecuteSql API to connect to the instance. For private IP instances, this allows authorized users to access the instance from the public internet using ExecuteSql API." |
7435 | 7570 | ], |
7436 | 7571 | "type": "string" |
7437 | 7572 | }, |
|
7523 | 7658 | "description": "Optional. When this parameter is set to true, Cloud SQL instances can connect to Vertex AI to pass requests for real-time predictions and insights to the AI. The default value is false. This applies only to Cloud SQL for MySQL and Cloud SQL for PostgreSQL instances.", |
7524 | 7659 | "type": "boolean" |
7525 | 7660 | }, |
| 7661 | + "entraidConfig": { |
| 7662 | + "$ref": "SqlServerEntraIdConfig", |
| 7663 | + "description": "Optional. The Microsoft Entra ID configuration for the SQL Server instance." |
| 7664 | + }, |
7526 | 7665 | "finalBackupConfig": { |
7527 | 7666 | "$ref": "FinalBackupConfig", |
7528 | 7667 | "description": "Optional. The final backup configuration for the instance." |
|
8181 | 8320 | }, |
8182 | 8321 | "type": "object" |
8183 | 8322 | }, |
| 8323 | + "SqlServerEntraIdConfig": { |
| 8324 | + "description": "SQL Server Entra ID configuration.", |
| 8325 | + "id": "SqlServerEntraIdConfig", |
| 8326 | + "properties": { |
| 8327 | + "applicationId": { |
| 8328 | + "description": "Optional. The application ID for the Entra ID configuration.", |
| 8329 | + "type": "string" |
| 8330 | + }, |
| 8331 | + "kind": { |
| 8332 | + "description": "Output only. This is always sql#sqlServerEntraIdConfig", |
| 8333 | + "readOnly": true, |
| 8334 | + "type": "string" |
| 8335 | + }, |
| 8336 | + "tenantId": { |
| 8337 | + "description": "Optional. The tenant ID for the Entra ID configuration.", |
| 8338 | + "type": "string" |
| 8339 | + } |
| 8340 | + }, |
| 8341 | + "type": "object" |
| 8342 | + }, |
8184 | 8343 | "SqlServerUserDetails": { |
8185 | 8344 | "description": "Represents a Sql Server user on the Cloud SQL instance.", |
8186 | 8345 | "id": "SqlServerUserDetails", |
|
8478 | 8637 | "description": "A Cloud SQL user resource.", |
8479 | 8638 | "id": "User", |
8480 | 8639 | "properties": { |
| 8640 | + "databaseRoles": { |
| 8641 | + "description": "Optional. Role memberships of the user", |
| 8642 | + "items": { |
| 8643 | + "type": "string" |
| 8644 | + }, |
| 8645 | + "type": "array" |
| 8646 | + }, |
8481 | 8647 | "dualPasswordType": { |
8482 | 8648 | "description": "Dual password status for the user.", |
8483 | 8649 | "enum": [ |
|
8555 | 8721 | "CLOUD_IAM_SERVICE_ACCOUNT", |
8556 | 8722 | "CLOUD_IAM_GROUP", |
8557 | 8723 | "CLOUD_IAM_GROUP_USER", |
8558 | | - "CLOUD_IAM_GROUP_SERVICE_ACCOUNT" |
| 8724 | + "CLOUD_IAM_GROUP_SERVICE_ACCOUNT", |
| 8725 | + "ENTRAID_USER" |
8559 | 8726 | ], |
8560 | 8727 | "enumDescriptions": [ |
8561 | 8728 | "The database's built-in user type.", |
8562 | 8729 | "Cloud IAM user.", |
8563 | 8730 | "Cloud IAM service account.", |
8564 | 8731 | "Cloud IAM group. Not used for login.", |
8565 | 8732 | "Read-only. Login for a user that belongs to the Cloud IAM group.", |
8566 | | - "Read-only. Login for a service account that belongs to the Cloud IAM group." |
| 8733 | + "Read-only. Login for a service account that belongs to the Cloud IAM group.", |
| 8734 | + "Microsoft Entra ID user." |
8567 | 8735 | ], |
8568 | 8736 | "type": "string" |
8569 | 8737 | } |
|
0 commit comments