feat(datamigration): update the API

#### datamigration:v1beta1 The following keys were changed: - schemas.Binding.properties.members.description #### datamigration:v1 The following keys were added: - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.flatPath - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.httpMethod - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.id - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameterOrder - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.options.requestedPolicyVersion.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.options.requestedPolicyVersion.format - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.options.requestedPolicyVersion.location - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.options.requestedPolicyVersion.type - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.resource.location - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.resource.pattern - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.resource.required - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.parameters.resource.type - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.path - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.response.$ref - resources.projects.resources.locations.resources.conversionWorkspaces.methods.getIamPolicy.scopes - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.flatPath - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.httpMethod - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.id - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.parameterOrder - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.parameters.resource.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.parameters.resource.location - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.parameters.resource.pattern - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.parameters.resource.required - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.parameters.resource.type - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.path - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.request.$ref - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.response.$ref - resources.projects.resources.locations.resources.conversionWorkspaces.methods.setIamPolicy.scopes - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.flatPath - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.httpMethod - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.id - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.parameterOrder - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.parameters.resource.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.parameters.resource.location - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.parameters.resource.pattern - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.parameters.resource.required - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.parameters.resource.type - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.path - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.request.$ref - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.response.$ref - resources.projects.resources.locations.resources.conversionWorkspaces.methods.testIamPermissions.scopes - resources.projects.resources.locations.resources.privateConnections.methods.create.parameters.skipValidation.description - resources.projects.resources.locations.resources.privateConnections.methods.create.parameters.skipValidation.location - resources.projects.resources.locations.resources.privateConnections.methods.create.parameters.skipValidation.type The following keys were changed: - resources.projects.resources.locations.resources.connectionProfiles.methods.create.parameters.requestId.description - resources.projects.resources.locations.resources.connectionProfiles.methods.patch.parameters.requestId.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.describeConversionWorkspaceRevisions.parameters.commitId.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.describeDatabaseEntities.parameters.filter.description - resources.projects.resources.locations.resources.conversionWorkspaces.methods.describeDatabaseEntities.parameters.tree.description - schemas.Binding.properties.members.description - schemas.CommitConversionWorkspaceRequest.properties.commitName.description - schemas.DatabaseEntity.properties.entityType.enum - schemas.DatabaseEntity.properties.entityType.enumDescriptions - schemas.SynonymEntity.properties.sourceType.enum - schemas.SynonymEntity.properties.sourceType.enumDescriptions
googleapis · Feb 2, 2023 · 4970228 · 4970228
1 parent 613aa91
commit 4970228
Show file tree

Hide file tree

Showing 4 changed files with 597 additions and 27 deletions.
diff --git a/discovery/datamigration-v1.json b/discovery/datamigration-v1.json
@@ -201,7 +201,7 @@
                       "type": "string"
                     },
                     "requestId": {
-                      "description": "A unique id used to identify the request. If the server receives two requests with the same id, then the second request will be ignored. It is recommended to always set this value to a UUID. The id must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.",
+                      "description": "Optional. A unique id used to identify the request. If the server receives two requests with the same id, then the second request will be ignored. It is recommended to always set this value to a UUID. The id must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.",
                       "location": "query",
                       "type": "string"
                     },
@@ -381,7 +381,7 @@
                       "type": "string"
                     },
                     "requestId": {
-                      "description": "A unique id used to identify the request. If the server receives two requests with the same id, then the second request will be ignored. It is recommended to always set this value to a UUID. The id must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.",
+                      "description": "Optional. A unique id used to identify the request. If the server receives two requests with the same id, then the second request will be ignored. It is recommended to always set this value to a UUID. The id must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.",
                       "location": "query",
                       "type": "string"
                     },
@@ -635,7 +635,7 @@
                   ],
                   "parameters": {
                     "commitId": {
-                      "description": "Optional filter to request a specific commit id",
+                      "description": "Optional. Optional filter to request a specific commit id",
                       "location": "query",
                       "type": "string"
                     },
@@ -677,7 +677,7 @@
                       "type": "string"
                     },
                     "filter": {
-                      "description": "Filter the returned entities based on AIP-160 standard",
+                      "description": "Filter the returned entities based on AIP-160 standard.",
                       "location": "query",
                       "type": "string"
                     },
@@ -693,7 +693,7 @@
                       "type": "string"
                     },
                     "tree": {
-                      "description": "The tree to fetch",
+                      "description": "The tree to fetch.",
                       "enum": [
                         "DB_TREE_TYPE_UNSPECIFIED",
                         "SOURCE_TREE",
@@ -748,6 +748,37 @@
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
                 },
+                "getIamPolicy": {
+                  "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/conversionWorkspaces/{conversionWorkspacesId}:getIamPolicy",
+                  "httpMethod": "GET",
+                  "id": "datamigration.projects.locations.conversionWorkspaces.getIamPolicy",
+                  "parameterOrder": [
+                    "resource"
+                  ],
+                  "parameters": {
+                    "options.requestedPolicyVersion": {
+                      "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).",
+                      "format": "int32",
+                      "location": "query",
+                      "type": "integer"
+                    },
+                    "resource": {
+                      "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/conversionWorkspaces/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+resource}:getIamPolicy",
+                  "response": {
+                    "$ref": "Policy"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
+                },
                 "list": {
                   "description": "Lists conversion workspaces in a given project and location.",
                   "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/conversionWorkspaces",
@@ -925,6 +956,62 @@
                   "scopes": [
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
+                },
+                "setIamPolicy": {
+                  "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/conversionWorkspaces/{conversionWorkspacesId}:setIamPolicy",
+                  "httpMethod": "POST",
+                  "id": "datamigration.projects.locations.conversionWorkspaces.setIamPolicy",
+                  "parameterOrder": [
+                    "resource"
+                  ],
+                  "parameters": {
+                    "resource": {
+                      "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/conversionWorkspaces/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+resource}:setIamPolicy",
+                  "request": {
+                    "$ref": "SetIamPolicyRequest"
+                  },
+                  "response": {
+                    "$ref": "Policy"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
+                },
+                "testIamPermissions": {
+                  "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/conversionWorkspaces/{conversionWorkspacesId}:testIamPermissions",
+                  "httpMethod": "POST",
+                  "id": "datamigration.projects.locations.conversionWorkspaces.testIamPermissions",
+                  "parameterOrder": [
+                    "resource"
+                  ],
+                  "parameters": {
+                    "resource": {
+                      "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/conversionWorkspaces/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+resource}:testIamPermissions",
+                  "request": {
+                    "$ref": "TestIamPermissionsRequest"
+                  },
+                  "response": {
+                    "$ref": "TestIamPermissionsResponse"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
                 }
               },
               "resources": {
@@ -1582,6 +1669,11 @@
                       "description": "Optional. A unique id used to identify the request. If the server receives two requests with the same id, then the second request will be ignored. It is recommended to always set this value to a UUID. The id must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40 characters.",
                       "location": "query",
                       "type": "string"
+                    },
+                    "skipValidation": {
+                      "description": "Optional. If set to true, will skip validations.",
+                      "location": "query",
+                      "type": "boolean"
                     }
                   },
                   "path": "v1/{+parent}/privateConnections",
@@ -1703,7 +1795,7 @@
       }
     }
   },
-  "revision": "20221211",
+  "revision": "20230125",
   "rootUrl": "https://datamigration.googleapis.com/",
   "schemas": {
     "AlloyDbConnectionProfile": {
@@ -1887,7 +1979,7 @@
           "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
         },
         "members": {
-          "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+          "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding.",
           "items": {
             "type": "string"
           },
@@ -2176,7 +2268,7 @@
       "id": "CommitConversionWorkspaceRequest",
       "properties": {
         "commitName": {
-          "description": "Optional name of the commit.",
+          "description": "Optional. Optional name of the commit.",
           "type": "string"
         }
       },
@@ -2471,7 +2563,8 @@
             "DATABASE_ENTITY_TYPE_FUNCTION",
             "DATABASE_ENTITY_TYPE_SYNONYM",
             "DATABASE_ENTITY_TYPE_DATABASE_PACKAGE",
-            "DATABASE_ENTITY_TYPE_UDT"
+            "DATABASE_ENTITY_TYPE_UDT",
+            "DATABASE_ENTITY_TYPE_MATERIAL_VIEW"
           ],
           "enumDescriptions": [
             "Unspecified database entity type",
@@ -2487,7 +2580,8 @@
             "Function",
             "Synonym",
             "Package",
-            "UDT"
+            "UDT",
+            "Material View"
           ],
           "type": "string"
         },
@@ -4083,7 +4177,8 @@
             "DATABASE_ENTITY_TYPE_FUNCTION",
             "DATABASE_ENTITY_TYPE_SYNONYM",
             "DATABASE_ENTITY_TYPE_DATABASE_PACKAGE",
-            "DATABASE_ENTITY_TYPE_UDT"
+            "DATABASE_ENTITY_TYPE_UDT",
+            "DATABASE_ENTITY_TYPE_MATERIAL_VIEW"
           ],
           "enumDescriptions": [
             "Unspecified database entity type",
@@ -4099,7 +4194,8 @@
             "Function",
             "Synonym",
             "Package",
-            "UDT"
+            "UDT",
+            "Material View"
           ],
           "type": "string"
         }