diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index 782d5bb5df..c2481c33b5 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -1095,7 +1095,7 @@ } } }, - "revision": "20240614", + "revision": "20240629", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -2600,6 +2600,7 @@ "properties": { "etag": { "description": "Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two Access Policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format.", + "readOnly": true, "type": "string" }, "name": { @@ -2835,7 +2836,7 @@ "type": "string" }, "sources": { - "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`.", + "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "items": { "$ref": "GoogleIdentityAccesscontextmanagerV1EgressSource" }, @@ -2864,7 +2865,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressSource", "properties": { "accessLevel": { - "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", + "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "type": "string" } }, @@ -3151,7 +3152,7 @@ "properties": { "vpcSubnetwork": { "$ref": "GoogleIdentityAccesscontextmanagerV1VpcSubNetwork", - "description": "Sub-segment ranges of a VPC network." + "description": "Sub-segment ranges of a VPC network. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out." } }, "type": "object" diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index b2496f931c..e20c3cbcf6 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -2972,7 +2972,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { SourceRestriction string `json:"sourceRestriction,omitempty"` // Sources: Sources that this EgressPolicy authorizes access from. If this // field is not empty, then `source_restriction` must be set to - // `SOURCE_RESTRICTION_ENABLED`. + // `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. Sources []*GoogleIdentityAccesscontextmanagerV1EgressSource `json:"sources,omitempty"` // ForceSendFields is a list of field names (e.g. "Identities") to // unconditionally include in API requests. By default, fields with empty or @@ -3042,7 +3043,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // can be accessed through Google Cloud calls with request origins within the // perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a // single `*` is specified for `access_level`, then all EgressSources will be - // allowed. + // allowed. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. AccessLevel string `json:"accessLevel,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or @@ -3486,7 +3488,9 @@ func (s *GoogleIdentityAccesscontextmanagerV1VpcAccessibleServices) MarshalJSON( // GoogleIdentityAccesscontextmanagerV1VpcNetworkSource: The originating // network source in Google Cloud. type GoogleIdentityAccesscontextmanagerV1VpcNetworkSource struct { - // VpcSubnetwork: Sub-segment ranges of a VPC network. + // VpcSubnetwork: Sub-segment ranges of a VPC network. TODO (b/332744441): + // annotate this field with custom_org_policy_accessibility when cl/640698580 + // will be rolled out. VpcSubnetwork *GoogleIdentityAccesscontextmanagerV1VpcSubNetwork `json:"vpcSubnetwork,omitempty"` // ForceSendFields is a list of field names (e.g. "VpcSubnetwork") to // unconditionally include in API requests. By default, fields with empty or diff --git a/cloudasset/v1beta1/cloudasset-api.json b/cloudasset/v1beta1/cloudasset-api.json index 532cbb141d..6e0cd2525c 100644 --- a/cloudasset/v1beta1/cloudasset-api.json +++ b/cloudasset/v1beta1/cloudasset-api.json @@ -411,7 +411,7 @@ } } }, - "revision": "20240608", + "revision": "20240629", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -925,6 +925,7 @@ "properties": { "etag": { "description": "Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two Access Policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format.", + "readOnly": true, "type": "string" }, "name": { @@ -1160,7 +1161,7 @@ "type": "string" }, "sources": { - "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`.", + "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "items": { "$ref": "GoogleIdentityAccesscontextmanagerV1EgressSource" }, @@ -1189,7 +1190,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressSource", "properties": { "accessLevel": { - "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", + "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "type": "string" } }, @@ -1476,7 +1477,7 @@ "properties": { "vpcSubnetwork": { "$ref": "GoogleIdentityAccesscontextmanagerV1VpcSubNetwork", - "description": "Sub-segment ranges of a VPC network." + "description": "Sub-segment ranges of a VPC network. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out." } }, "type": "object" diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index fb16354cbd..9178356d15 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -1444,7 +1444,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { SourceRestriction string `json:"sourceRestriction,omitempty"` // Sources: Sources that this EgressPolicy authorizes access from. If this // field is not empty, then `source_restriction` must be set to - // `SOURCE_RESTRICTION_ENABLED`. + // `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. Sources []*GoogleIdentityAccesscontextmanagerV1EgressSource `json:"sources,omitempty"` // ForceSendFields is a list of field names (e.g. "Identities") to // unconditionally include in API requests. By default, fields with empty or @@ -1514,7 +1515,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // can be accessed through Google Cloud calls with request origins within the // perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a // single `*` is specified for `access_level`, then all EgressSources will be - // allowed. + // allowed. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. AccessLevel string `json:"accessLevel,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or @@ -1958,7 +1960,9 @@ func (s *GoogleIdentityAccesscontextmanagerV1VpcAccessibleServices) MarshalJSON( // GoogleIdentityAccesscontextmanagerV1VpcNetworkSource: The originating // network source in Google Cloud. type GoogleIdentityAccesscontextmanagerV1VpcNetworkSource struct { - // VpcSubnetwork: Sub-segment ranges of a VPC network. + // VpcSubnetwork: Sub-segment ranges of a VPC network. TODO (b/332744441): + // annotate this field with custom_org_policy_accessibility when cl/640698580 + // will be rolled out. VpcSubnetwork *GoogleIdentityAccesscontextmanagerV1VpcSubNetwork `json:"vpcSubnetwork,omitempty"` // ForceSendFields is a list of field names (e.g. "VpcSubnetwork") to // unconditionally include in API requests. By default, fields with empty or diff --git a/cloudasset/v1p1beta1/cloudasset-api.json b/cloudasset/v1p1beta1/cloudasset-api.json index cdc9c5465e..53266af619 100644 --- a/cloudasset/v1p1beta1/cloudasset-api.json +++ b/cloudasset/v1p1beta1/cloudasset-api.json @@ -207,7 +207,7 @@ } } }, - "revision": "20240608", + "revision": "20240629", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -627,6 +627,7 @@ "properties": { "etag": { "description": "Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two Access Policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format.", + "readOnly": true, "type": "string" }, "name": { @@ -862,7 +863,7 @@ "type": "string" }, "sources": { - "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`.", + "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "items": { "$ref": "GoogleIdentityAccesscontextmanagerV1EgressSource" }, @@ -891,7 +892,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressSource", "properties": { "accessLevel": { - "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", + "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "type": "string" } }, @@ -1178,7 +1179,7 @@ "properties": { "vpcSubnetwork": { "$ref": "GoogleIdentityAccesscontextmanagerV1VpcSubNetwork", - "description": "Sub-segment ranges of a VPC network." + "description": "Sub-segment ranges of a VPC network. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out." } }, "type": "object" diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index 1a95995e4d..9ed7549901 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -1255,7 +1255,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { SourceRestriction string `json:"sourceRestriction,omitempty"` // Sources: Sources that this EgressPolicy authorizes access from. If this // field is not empty, then `source_restriction` must be set to - // `SOURCE_RESTRICTION_ENABLED`. + // `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. Sources []*GoogleIdentityAccesscontextmanagerV1EgressSource `json:"sources,omitempty"` // ForceSendFields is a list of field names (e.g. "Identities") to // unconditionally include in API requests. By default, fields with empty or @@ -1325,7 +1326,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // can be accessed through Google Cloud calls with request origins within the // perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a // single `*` is specified for `access_level`, then all EgressSources will be - // allowed. + // allowed. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. AccessLevel string `json:"accessLevel,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or @@ -1769,7 +1771,9 @@ func (s *GoogleIdentityAccesscontextmanagerV1VpcAccessibleServices) MarshalJSON( // GoogleIdentityAccesscontextmanagerV1VpcNetworkSource: The originating // network source in Google Cloud. type GoogleIdentityAccesscontextmanagerV1VpcNetworkSource struct { - // VpcSubnetwork: Sub-segment ranges of a VPC network. + // VpcSubnetwork: Sub-segment ranges of a VPC network. TODO (b/332744441): + // annotate this field with custom_org_policy_accessibility when cl/640698580 + // will be rolled out. VpcSubnetwork *GoogleIdentityAccesscontextmanagerV1VpcSubNetwork `json:"vpcSubnetwork,omitempty"` // ForceSendFields is a list of field names (e.g. "VpcSubnetwork") to // unconditionally include in API requests. By default, fields with empty or diff --git a/cloudasset/v1p5beta1/cloudasset-api.json b/cloudasset/v1p5beta1/cloudasset-api.json index b14e0d57bd..076c32f899 100644 --- a/cloudasset/v1p5beta1/cloudasset-api.json +++ b/cloudasset/v1p5beta1/cloudasset-api.json @@ -177,7 +177,7 @@ } } }, - "revision": "20240608", + "revision": "20240629", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -632,6 +632,7 @@ "properties": { "etag": { "description": "Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two Access Policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format.", + "readOnly": true, "type": "string" }, "name": { @@ -867,7 +868,7 @@ "type": "string" }, "sources": { - "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`.", + "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "items": { "$ref": "GoogleIdentityAccesscontextmanagerV1EgressSource" }, @@ -896,7 +897,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressSource", "properties": { "accessLevel": { - "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", + "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "type": "string" } }, @@ -1183,7 +1184,7 @@ "properties": { "vpcSubnetwork": { "$ref": "GoogleIdentityAccesscontextmanagerV1VpcSubNetwork", - "description": "Sub-segment ranges of a VPC network." + "description": "Sub-segment ranges of a VPC network. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out." } }, "type": "object" diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index a2854b6096..08758bfe29 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -1289,7 +1289,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { SourceRestriction string `json:"sourceRestriction,omitempty"` // Sources: Sources that this EgressPolicy authorizes access from. If this // field is not empty, then `source_restriction` must be set to - // `SOURCE_RESTRICTION_ENABLED`. + // `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. Sources []*GoogleIdentityAccesscontextmanagerV1EgressSource `json:"sources,omitempty"` // ForceSendFields is a list of field names (e.g. "Identities") to // unconditionally include in API requests. By default, fields with empty or @@ -1359,7 +1360,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // can be accessed through Google Cloud calls with request origins within the // perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a // single `*` is specified for `access_level`, then all EgressSources will be - // allowed. + // allowed. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. AccessLevel string `json:"accessLevel,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or @@ -1803,7 +1805,9 @@ func (s *GoogleIdentityAccesscontextmanagerV1VpcAccessibleServices) MarshalJSON( // GoogleIdentityAccesscontextmanagerV1VpcNetworkSource: The originating // network source in Google Cloud. type GoogleIdentityAccesscontextmanagerV1VpcNetworkSource struct { - // VpcSubnetwork: Sub-segment ranges of a VPC network. + // VpcSubnetwork: Sub-segment ranges of a VPC network. TODO (b/332744441): + // annotate this field with custom_org_policy_accessibility when cl/640698580 + // will be rolled out. VpcSubnetwork *GoogleIdentityAccesscontextmanagerV1VpcSubNetwork `json:"vpcSubnetwork,omitempty"` // ForceSendFields is a list of field names (e.g. "VpcSubnetwork") to // unconditionally include in API requests. By default, fields with empty or diff --git a/cloudasset/v1p7beta1/cloudasset-api.json b/cloudasset/v1p7beta1/cloudasset-api.json index 136b95fa7d..4dcce16969 100644 --- a/cloudasset/v1p7beta1/cloudasset-api.json +++ b/cloudasset/v1p7beta1/cloudasset-api.json @@ -167,7 +167,7 @@ } } }, - "revision": "20240608", + "revision": "20240629", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -701,6 +701,7 @@ "properties": { "etag": { "description": "Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two Access Policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format.", + "readOnly": true, "type": "string" }, "name": { @@ -936,7 +937,7 @@ "type": "string" }, "sources": { - "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`.", + "description": "Sources that this EgressPolicy authorizes access from. If this field is not empty, then `source_restriction` must be set to `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "items": { "$ref": "GoogleIdentityAccesscontextmanagerV1EgressSource" }, @@ -965,7 +966,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressSource", "properties": { "accessLevel": { - "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", + "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out.", "type": "string" } }, @@ -1252,7 +1253,7 @@ "properties": { "vpcSubnetwork": { "$ref": "GoogleIdentityAccesscontextmanagerV1VpcSubNetwork", - "description": "Sub-segment ranges of a VPC network." + "description": "Sub-segment ranges of a VPC network. TODO (b/332744441): annotate this field with custom_org_policy_accessibility when cl/640698580 will be rolled out." } }, "type": "object" diff --git a/cloudasset/v1p7beta1/cloudasset-gen.go b/cloudasset/v1p7beta1/cloudasset-gen.go index 1bb92526bd..b86aaf65d8 100644 --- a/cloudasset/v1p7beta1/cloudasset-gen.go +++ b/cloudasset/v1p7beta1/cloudasset-gen.go @@ -1465,7 +1465,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { SourceRestriction string `json:"sourceRestriction,omitempty"` // Sources: Sources that this EgressPolicy authorizes access from. If this // field is not empty, then `source_restriction` must be set to - // `SOURCE_RESTRICTION_ENABLED`. + // `SOURCE_RESTRICTION_ENABLED`. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. Sources []*GoogleIdentityAccesscontextmanagerV1EgressSource `json:"sources,omitempty"` // ForceSendFields is a list of field names (e.g. "Identities") to // unconditionally include in API requests. By default, fields with empty or @@ -1535,7 +1536,8 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // can be accessed through Google Cloud calls with request origins within the // perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a // single `*` is specified for `access_level`, then all EgressSources will be - // allowed. + // allowed. TODO (b/332744441): annotate this field with + // custom_org_policy_accessibility when cl/640698580 will be rolled out. AccessLevel string `json:"accessLevel,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or @@ -1979,7 +1981,9 @@ func (s *GoogleIdentityAccesscontextmanagerV1VpcAccessibleServices) MarshalJSON( // GoogleIdentityAccesscontextmanagerV1VpcNetworkSource: The originating // network source in Google Cloud. type GoogleIdentityAccesscontextmanagerV1VpcNetworkSource struct { - // VpcSubnetwork: Sub-segment ranges of a VPC network. + // VpcSubnetwork: Sub-segment ranges of a VPC network. TODO (b/332744441): + // annotate this field with custom_org_policy_accessibility when cl/640698580 + // will be rolled out. VpcSubnetwork *GoogleIdentityAccesscontextmanagerV1VpcSubNetwork `json:"vpcSubnetwork,omitempty"` // ForceSendFields is a list of field names (e.g. "VpcSubnetwork") to // unconditionally include in API requests. By default, fields with empty or diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index 6f7756edca..7bf3d01fb2 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -2427,7 +2427,7 @@ } } }, - "revision": "20240625", + "revision": "20240701", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { @@ -2600,7 +2600,7 @@ }, "omitQueryParams": { "description": "Optional. Omit query params from the redirect URI.", - "type": "string" + "type": "boolean" }, "scopes": { "description": "The scopes for which the user will authorize Google Cloud Connectors on the connector data source.", diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index 7a6545ed91..09c5c8aaae 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -554,7 +554,7 @@ type AuthorizationCodeLink struct { // EnablePkce: Whether to enable PKCE for the auth code flow. EnablePkce bool `json:"enablePkce,omitempty"` // OmitQueryParams: Optional. Omit query params from the redirect URI. - OmitQueryParams string `json:"omitQueryParams,omitempty"` + OmitQueryParams bool `json:"omitQueryParams,omitempty"` // Scopes: The scopes for which the user will authorize Google Cloud Connectors // on the connector data source. Scopes []string `json:"scopes,omitempty"` diff --git a/datafusion/v1/datafusion-api.json b/datafusion/v1/datafusion-api.json index 540ae9f761..2793f26985 100644 --- a/datafusion/v1/datafusion-api.json +++ b/datafusion/v1/datafusion-api.json @@ -732,7 +732,7 @@ } } }, - "revision": "20240618", + "revision": "20240703", "rootUrl": "https://datafusion.googleapis.com/", "schemas": { "Accelerator": { @@ -777,6 +777,38 @@ }, "type": "object" }, + "AssetLocation": { + "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", + "id": "AssetLocation", + "properties": { + "expected": { + "$ref": "IsolationExpectations", + "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." + }, + "extraParameters": { + "description": "Defines extra parameters required for specific asset types.", + "items": { + "$ref": "ExtraParameter" + }, + "type": "array" + }, + "locationData": { + "description": "Contains all kinds of physical location definitions for this asset.", + "items": { + "$ref": "LocationData" + }, + "type": "array" + }, + "parentAsset": { + "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", + "items": { + "$ref": "CloudAsset" + }, + "type": "array" + } + }, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -847,12 +879,49 @@ }, "type": "object" }, + "BlobstoreLocation": { + "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", + "id": "BlobstoreLocation", + "properties": { + "policyId": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "properties": {}, "type": "object" }, + "CloudAsset": { + "id": "CloudAsset", + "properties": { + "assetName": { + "type": "string" + }, + "assetType": { + "type": "string" + } + }, + "type": "object" + }, + "CloudAssetComposition": { + "id": "CloudAssetComposition", + "properties": { + "childAsset": { + "items": { + "$ref": "CloudAsset" + }, + "type": "array" + } + }, + "type": "object" + }, "CryptoKeyConfig": { "description": "The crypto key configuration. This field is used by the Customer-managed encryption keys (CMEK) feature.", "id": "CryptoKeyConfig", @@ -864,6 +933,18 @@ }, "type": "object" }, + "DirectLocationAssignment": { + "id": "DirectLocationAssignment", + "properties": { + "location": { + "items": { + "$ref": "LocationAssignment" + }, + "type": "array" + } + }, + "type": "object" + }, "DnsPeering": { "description": "DNS peering configuration. These configurations are used to create DNS peering with the customer Cloud DNS.", "id": "DnsPeering", @@ -935,6 +1016,17 @@ }, "type": "object" }, + "ExtraParameter": { + "description": "Defines parameters that should only be used for specific asset types.", + "id": "ExtraParameter", + "properties": { + "regionalMigDistributionPolicy": { + "$ref": "RegionalMigDistributionPolicy", + "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." + } + }, + "type": "object" + }, "Instance": { "description": "Represents a Data Fusion instance.", "id": "Instance", @@ -1162,6 +1254,127 @@ }, "type": "object" }, + "IsolationExpectations": { + "id": "IsolationExpectations", + "properties": { + "ziOrgPolicy": { + "enum": [ + "ZI_UNSPECIFIED", + "ZI_UNKNOWN", + "ZI_NOT_REQUIRED", + "ZI_PREFERRED", + "ZI_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "ziRegionPolicy": { + "enum": [ + "ZI_REGION_POLICY_UNSPECIFIED", + "ZI_REGION_POLICY_UNKNOWN", + "ZI_REGION_POLICY_NOT_SET", + "ZI_REGION_POLICY_FAIL_OPEN", + "ZI_REGION_POLICY_FAIL_CLOSED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "ziRegionState": { + "enum": [ + "ZI_REGION_UNSPECIFIED", + "ZI_REGION_UNKNOWN", + "ZI_REGION_NOT_ENABLED", + "ZI_REGION_ENABLED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zoneIsolation": { + "deprecated": true, + "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", + "enum": [ + "ZI_UNSPECIFIED", + "ZI_UNKNOWN", + "ZI_NOT_REQUIRED", + "ZI_PREFERRED", + "ZI_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "zoneSeparation": { + "deprecated": true, + "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", + "enum": [ + "ZS_UNSPECIFIED", + "ZS_UNKNOWN", + "ZS_NOT_REQUIRED", + "ZS_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zsOrgPolicy": { + "enum": [ + "ZS_UNSPECIFIED", + "ZS_UNKNOWN", + "ZS_NOT_REQUIRED", + "ZS_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zsRegionState": { + "enum": [ + "ZS_REGION_UNSPECIFIED", + "ZS_REGION_UNKNOWN", + "ZS_REGION_NOT_ENABLED", + "ZS_REGION_ENABLED" + ], + "enumDescriptions": [ + "", + "To be used if tracking of the asset ZS-bit is not available", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "ListAvailableVersionsResponse": { "description": "Response message for the list available versions request.", "id": "ListAvailableVersionsResponse", @@ -1293,6 +1506,64 @@ }, "type": "object" }, + "LocationAssignment": { + "id": "LocationAssignment", + "properties": { + "location": { + "type": "string" + }, + "locationType": { + "enum": [ + "UNSPECIFIED", + "CLUSTER", + "POP", + "CLOUD_ZONE", + "CLOUD_REGION", + "MULTI_REGION_GEO", + "MULTI_REGION_JURISDICTION", + "GLOBAL", + "OTHER" + ], + "enumDescriptions": [ + "", + "1-10: Physical failure domains.", + "", + "11-20: Logical failure domains.", + "", + "", + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "LocationData": { + "id": "LocationData", + "properties": { + "blobstoreLocation": { + "$ref": "BlobstoreLocation" + }, + "childAssetLocation": { + "$ref": "CloudAssetComposition" + }, + "directLocation": { + "$ref": "DirectLocationAssignment" + }, + "gcpProjectProxy": { + "$ref": "TenantProjectProxy" + }, + "placerLocation": { + "$ref": "PlacerLocation" + }, + "spannerLocation": { + "$ref": "SpannerLocation" + } + }, + "type": "object" + }, "MaintenancePolicy": { "description": "Maintenance policy of the instance.", "id": "MaintenancePolicy", @@ -1431,6 +1702,17 @@ }, "type": "object" }, + "PlacerLocation": { + "description": "Message describing that the location of the customer resource is tied to placer allocations", + "id": "PlacerLocation", + "properties": { + "placerConfig": { + "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", + "type": "string" + } + }, + "type": "object" + }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", @@ -1497,6 +1779,25 @@ }, "type": "object" }, + "RegionalMigDistributionPolicy": { + "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", + "id": "RegionalMigDistributionPolicy", + "properties": { + "targetShape": { + "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", + "format": "int32", + "type": "integer" + }, + "zones": { + "description": "Cloud zones used by regional MIG to create instances.", + "items": { + "$ref": "ZoneConfiguration" + }, + "type": "array" + } + }, + "type": "object" + }, "RestartInstanceRequest": { "description": "Request message for restarting a Data Fusion instance.", "id": "RestartInstanceRequest", @@ -1519,6 +1820,26 @@ }, "type": "object" }, + "SpannerLocation": { + "id": "SpannerLocation", + "properties": { + "backupName": { + "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", + "items": { + "type": "string" + }, + "type": "array" + }, + "dbName": { + "description": "Set of databases used by the resource in format /span//", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -1546,6 +1867,18 @@ }, "type": "object" }, + "TenantProjectProxy": { + "id": "TenantProjectProxy", + "properties": { + "projectNumbers": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "TestIamPermissionsRequest": { "description": "Request message for `TestIamPermissions` method.", "id": "TestIamPermissionsRequest", @@ -1626,6 +1959,15 @@ } }, "type": "object" + }, + "ZoneConfiguration": { + "id": "ZoneConfiguration", + "properties": { + "zone": { + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/datafusion/v1/datafusion-gen.go b/datafusion/v1/datafusion-gen.go index 138ae022af..c1e98c4dab 100644 --- a/datafusion/v1/datafusion-gen.go +++ b/datafusion/v1/datafusion-gen.go @@ -266,6 +266,38 @@ func (s *Accelerator) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// AssetLocation: Provides the mapping of a cloud asset to a direct physical +// location or to a proxy that defines the location on its behalf. +type AssetLocation struct { + // Expected: Defines the customer expectation around ZI/ZS for this asset and + // ZI/ZS state of the region at the time of asset creation. + Expected *IsolationExpectations `json:"expected,omitempty"` + // ExtraParameters: Defines extra parameters required for specific asset types. + ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` + // LocationData: Contains all kinds of physical location definitions for this + // asset. + LocationData []*LocationData `json:"locationData,omitempty"` + // ParentAsset: Defines parents assets if any in order to allow later + // generation of child_asset_location data via child assets. + ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` + // ForceSendFields is a list of field names (e.g. "Expected") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Expected") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *AssetLocation) MarshalJSON() ([]byte, error) { + type NoMethod AssetLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must have one @@ -441,10 +473,73 @@ func (s *Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// BlobstoreLocation: Policy ID that identified data placement in Blobstore as +// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains +type BlobstoreLocation struct { + PolicyId []string `json:"policyId,omitempty"` + // ForceSendFields is a list of field names (e.g. "PolicyId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PolicyId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *BlobstoreLocation) MarshalJSON() ([]byte, error) { + type NoMethod BlobstoreLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } +type CloudAsset struct { + AssetName string `json:"assetName,omitempty"` + AssetType string `json:"assetType,omitempty"` + // ForceSendFields is a list of field names (e.g. "AssetName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AssetName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *CloudAsset) MarshalJSON() ([]byte, error) { + type NoMethod CloudAsset + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +type CloudAssetComposition struct { + ChildAsset []*CloudAsset `json:"childAsset,omitempty"` + // ForceSendFields is a list of field names (e.g. "ChildAsset") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ChildAsset") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *CloudAssetComposition) MarshalJSON() ([]byte, error) { + type NoMethod CloudAssetComposition + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // CryptoKeyConfig: The crypto key configuration. This field is used by the // Customer-managed encryption keys (CMEK) feature. type CryptoKeyConfig struct { @@ -470,6 +565,26 @@ func (s *CryptoKeyConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type DirectLocationAssignment struct { + Location []*LocationAssignment `json:"location,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Location") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *DirectLocationAssignment) MarshalJSON() ([]byte, error) { + type NoMethod DirectLocationAssignment + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // DnsPeering: DNS peering configuration. These configurations are used to // create DNS peering with the customer Cloud DNS. type DnsPeering struct { @@ -590,6 +705,30 @@ func (s *Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// ExtraParameter: Defines parameters that should only be used for specific +// asset types. +type ExtraParameter struct { + // RegionalMigDistributionPolicy: Details about zones used by regional + // compute.googleapis.com/InstanceGroupManager to create instances. + RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "RegionalMigDistributionPolicy") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") + // to include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *ExtraParameter) MarshalJSON() ([]byte, error) { + type NoMethod ExtraParameter + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Instance: Represents a Data Fusion instance. type Instance struct { // Accelerators: Output only. List of accelerators enabled for this CDF @@ -738,6 +877,78 @@ func (s *Instance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type IsolationExpectations struct { + // Possible values: + // "ZI_UNSPECIFIED" + // "ZI_UNKNOWN" - To be used if tracking is not available + // "ZI_NOT_REQUIRED" + // "ZI_PREFERRED" + // "ZI_REQUIRED" + ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` + // Possible values: + // "ZI_REGION_POLICY_UNSPECIFIED" + // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available + // "ZI_REGION_POLICY_NOT_SET" + // "ZI_REGION_POLICY_FAIL_OPEN" + // "ZI_REGION_POLICY_FAIL_CLOSED" + ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` + // Possible values: + // "ZI_REGION_UNSPECIFIED" + // "ZI_REGION_UNKNOWN" - To be used if tracking is not available + // "ZI_REGION_NOT_ENABLED" + // "ZI_REGION_ENABLED" + ZiRegionState string `json:"ziRegionState,omitempty"` + // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and + // zi_region_state instead for setting ZI expectations as per + // go/zicy-publish-physical-location. + // + // Possible values: + // "ZI_UNSPECIFIED" + // "ZI_UNKNOWN" - To be used if tracking is not available + // "ZI_NOT_REQUIRED" + // "ZI_PREFERRED" + // "ZI_REQUIRED" + ZoneIsolation string `json:"zoneIsolation,omitempty"` + // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead + // for setting Zs expectations as per go/zicy-publish-physical-location. + // + // Possible values: + // "ZS_UNSPECIFIED" + // "ZS_UNKNOWN" - To be used if tracking is not available + // "ZS_NOT_REQUIRED" + // "ZS_REQUIRED" + ZoneSeparation string `json:"zoneSeparation,omitempty"` + // Possible values: + // "ZS_UNSPECIFIED" + // "ZS_UNKNOWN" - To be used if tracking is not available + // "ZS_NOT_REQUIRED" + // "ZS_REQUIRED" + ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` + // Possible values: + // "ZS_REGION_UNSPECIFIED" + // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not + // available + // "ZS_REGION_NOT_ENABLED" + // "ZS_REGION_ENABLED" + ZsRegionState string `json:"zsRegionState,omitempty"` + // ForceSendFields is a list of field names (e.g. "ZiOrgPolicy") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ZiOrgPolicy") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *IsolationExpectations) MarshalJSON() ([]byte, error) { + type NoMethod IsolationExpectations + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // ListAvailableVersionsResponse: Response message for the list available // versions request. type ListAvailableVersionsResponse struct { @@ -919,6 +1130,62 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type LocationAssignment struct { + Location string `json:"location,omitempty"` + // Possible values: + // "UNSPECIFIED" + // "CLUSTER" - 1-10: Physical failure domains. + // "POP" + // "CLOUD_ZONE" - 11-20: Logical failure domains. + // "CLOUD_REGION" + // "MULTI_REGION_GEO" + // "MULTI_REGION_JURISDICTION" + // "GLOBAL" + // "OTHER" + LocationType string `json:"locationType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Location") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *LocationAssignment) MarshalJSON() ([]byte, error) { + type NoMethod LocationAssignment + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +type LocationData struct { + BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` + ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` + DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` + GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` + PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` + SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` + // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *LocationData) MarshalJSON() ([]byte, error) { + type NoMethod LocationData + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // MaintenancePolicy: Maintenance policy of the instance. type MaintenancePolicy struct { // MaintenanceExclusionWindow: Optional. The maintenance exclusion window of @@ -1113,6 +1380,30 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// PlacerLocation: Message describing that the location of the customer +// resource is tied to placer allocations +type PlacerLocation struct { + // PlacerConfig: Directory with a config related to it in placer (e.g. + // "/placer/prod/home/my-root/my-dir") + PlacerConfig string `json:"placerConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "PlacerConfig") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PlacerConfig") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *PlacerLocation) MarshalJSON() ([]byte, error) { + type NoMethod PlacerLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Policy: An Identity and Access Management (IAM) policy, which specifies // access controls for Google Cloud resources. A `Policy` is a collection of // `bindings`. A `binding` binds one or more `members`, or principals, to a @@ -1281,6 +1572,33 @@ func (s *RecurringTimeWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// RegionalMigDistributionPolicy: To be used for specifying the intended +// distribution of regional compute.googleapis.com/InstanceGroupManager +// instances +type RegionalMigDistributionPolicy struct { + // TargetShape: The shape in which the group converges around distribution of + // resources. Instance of proto2 enum + TargetShape int64 `json:"targetShape,omitempty"` + // Zones: Cloud zones used by regional MIG to create instances. + Zones []*ZoneConfiguration `json:"zones,omitempty"` + // ForceSendFields is a list of field names (e.g. "TargetShape") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "TargetShape") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { + type NoMethod RegionalMigDistributionPolicy + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // RestartInstanceRequest: Request message for restarting a Data Fusion // instance. type RestartInstanceRequest struct { @@ -1315,6 +1633,30 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type SpannerLocation struct { + // BackupName: Set of backups used by the resource with name in the same format + // as what is available at http://table/spanner_automon.backup_metadata + BackupName []string `json:"backupName,omitempty"` + // DbName: Set of databases used by the resource in format /span// + DbName []string `json:"dbName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *SpannerLocation) MarshalJSON() ([]byte, error) { + type NoMethod SpannerLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Status: 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 @@ -1349,6 +1691,26 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type TenantProjectProxy struct { + ProjectNumbers []string `json:"projectNumbers,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ProjectNumbers") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *TenantProjectProxy) MarshalJSON() ([]byte, error) { + type NoMethod TenantProjectProxy + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // TestIamPermissionsRequest: Request message for `TestIamPermissions` method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. Permissions @@ -1467,6 +1829,26 @@ func (s *Version) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type ZoneConfiguration struct { + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Zone") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *ZoneConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod ZoneConfiguration + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + type ProjectsLocationsGetCall struct { s *Service name string diff --git a/datafusion/v1beta1/datafusion-api.json b/datafusion/v1beta1/datafusion-api.json index f7595fd47d..bf5a2af337 100644 --- a/datafusion/v1beta1/datafusion-api.json +++ b/datafusion/v1beta1/datafusion-api.json @@ -930,7 +930,7 @@ } } }, - "revision": "20240618", + "revision": "20240703", "rootUrl": "https://datafusion.googleapis.com/", "schemas": { "Accelerator": { @@ -975,6 +975,38 @@ }, "type": "object" }, + "AssetLocation": { + "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", + "id": "AssetLocation", + "properties": { + "expected": { + "$ref": "IsolationExpectations", + "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." + }, + "extraParameters": { + "description": "Defines extra parameters required for specific asset types.", + "items": { + "$ref": "ExtraParameter" + }, + "type": "array" + }, + "locationData": { + "description": "Contains all kinds of physical location definitions for this asset.", + "items": { + "$ref": "LocationData" + }, + "type": "array" + }, + "parentAsset": { + "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", + "items": { + "$ref": "CloudAsset" + }, + "type": "array" + } + }, + "type": "object" + }, "AuditConfig": { "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", @@ -1045,12 +1077,49 @@ }, "type": "object" }, + "BlobstoreLocation": { + "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", + "id": "BlobstoreLocation", + "properties": { + "policyId": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "properties": {}, "type": "object" }, + "CloudAsset": { + "id": "CloudAsset", + "properties": { + "assetName": { + "type": "string" + }, + "assetType": { + "type": "string" + } + }, + "type": "object" + }, + "CloudAssetComposition": { + "id": "CloudAssetComposition", + "properties": { + "childAsset": { + "items": { + "$ref": "CloudAsset" + }, + "type": "array" + } + }, + "type": "object" + }, "CryptoKeyConfig": { "description": "The crypto key configuration. This field is used by the Customer-managed encryption keys (CMEK) feature.", "id": "CryptoKeyConfig", @@ -1062,6 +1131,18 @@ }, "type": "object" }, + "DirectLocationAssignment": { + "id": "DirectLocationAssignment", + "properties": { + "location": { + "items": { + "$ref": "LocationAssignment" + }, + "type": "array" + } + }, + "type": "object" + }, "DnsPeering": { "description": "DNS peering configuration. These configurations are used to create DNS peering with the customer Cloud DNS.", "id": "DnsPeering", @@ -1133,6 +1214,17 @@ }, "type": "object" }, + "ExtraParameter": { + "description": "Defines parameters that should only be used for specific asset types.", + "id": "ExtraParameter", + "properties": { + "regionalMigDistributionPolicy": { + "$ref": "RegionalMigDistributionPolicy", + "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." + } + }, + "type": "object" + }, "IAMPolicy": { "description": "IAMPolicy encapsulates the IAM policy name, definition and status of policy fetching.", "id": "IAMPolicy", @@ -1375,6 +1467,127 @@ }, "type": "object" }, + "IsolationExpectations": { + "id": "IsolationExpectations", + "properties": { + "ziOrgPolicy": { + "enum": [ + "ZI_UNSPECIFIED", + "ZI_UNKNOWN", + "ZI_NOT_REQUIRED", + "ZI_PREFERRED", + "ZI_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "ziRegionPolicy": { + "enum": [ + "ZI_REGION_POLICY_UNSPECIFIED", + "ZI_REGION_POLICY_UNKNOWN", + "ZI_REGION_POLICY_NOT_SET", + "ZI_REGION_POLICY_FAIL_OPEN", + "ZI_REGION_POLICY_FAIL_CLOSED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "ziRegionState": { + "enum": [ + "ZI_REGION_UNSPECIFIED", + "ZI_REGION_UNKNOWN", + "ZI_REGION_NOT_ENABLED", + "ZI_REGION_ENABLED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zoneIsolation": { + "deprecated": true, + "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", + "enum": [ + "ZI_UNSPECIFIED", + "ZI_UNKNOWN", + "ZI_NOT_REQUIRED", + "ZI_PREFERRED", + "ZI_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "zoneSeparation": { + "deprecated": true, + "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", + "enum": [ + "ZS_UNSPECIFIED", + "ZS_UNKNOWN", + "ZS_NOT_REQUIRED", + "ZS_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zsOrgPolicy": { + "enum": [ + "ZS_UNSPECIFIED", + "ZS_UNKNOWN", + "ZS_NOT_REQUIRED", + "ZS_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zsRegionState": { + "enum": [ + "ZS_REGION_UNSPECIFIED", + "ZS_REGION_UNKNOWN", + "ZS_REGION_NOT_ENABLED", + "ZS_REGION_ENABLED" + ], + "enumDescriptions": [ + "", + "To be used if tracking of the asset ZS-bit is not available", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "ListAvailableVersionsResponse": { "description": "Response message for the list available versions request.", "id": "ListAvailableVersionsResponse", @@ -1524,6 +1737,64 @@ }, "type": "object" }, + "LocationAssignment": { + "id": "LocationAssignment", + "properties": { + "location": { + "type": "string" + }, + "locationType": { + "enum": [ + "UNSPECIFIED", + "CLUSTER", + "POP", + "CLOUD_ZONE", + "CLOUD_REGION", + "MULTI_REGION_GEO", + "MULTI_REGION_JURISDICTION", + "GLOBAL", + "OTHER" + ], + "enumDescriptions": [ + "", + "1-10: Physical failure domains.", + "", + "11-20: Logical failure domains.", + "", + "", + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "LocationData": { + "id": "LocationData", + "properties": { + "blobstoreLocation": { + "$ref": "BlobstoreLocation" + }, + "childAssetLocation": { + "$ref": "CloudAssetComposition" + }, + "directLocation": { + "$ref": "DirectLocationAssignment" + }, + "gcpProjectProxy": { + "$ref": "TenantProjectProxy" + }, + "placerLocation": { + "$ref": "PlacerLocation" + }, + "spannerLocation": { + "$ref": "SpannerLocation" + } + }, + "type": "object" + }, "MaintenancePolicy": { "description": "Maintenance policy of the instance.", "id": "MaintenancePolicy", @@ -1677,6 +1948,17 @@ }, "type": "object" }, + "PlacerLocation": { + "description": "Message describing that the location of the customer resource is tied to placer allocations", + "id": "PlacerLocation", + "properties": { + "placerConfig": { + "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", + "type": "string" + } + }, + "type": "object" + }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", @@ -1743,6 +2025,25 @@ }, "type": "object" }, + "RegionalMigDistributionPolicy": { + "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", + "id": "RegionalMigDistributionPolicy", + "properties": { + "targetShape": { + "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", + "format": "int32", + "type": "integer" + }, + "zones": { + "description": "Cloud zones used by regional MIG to create instances.", + "items": { + "$ref": "ZoneConfiguration" + }, + "type": "array" + } + }, + "type": "object" + }, "RemoveIamPolicyRequest": { "description": "Request message for RemoveIamPolicy method.", "id": "RemoveIamPolicyRequest", @@ -1777,6 +2078,26 @@ }, "type": "object" }, + "SpannerLocation": { + "id": "SpannerLocation", + "properties": { + "backupName": { + "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", + "items": { + "type": "string" + }, + "type": "array" + }, + "dbName": { + "description": "Set of databases used by the resource in format /span//", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -1804,6 +2125,18 @@ }, "type": "object" }, + "TenantProjectProxy": { + "id": "TenantProjectProxy", + "properties": { + "projectNumbers": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "TestIamPermissionsRequest": { "description": "Request message for `TestIamPermissions` method.", "id": "TestIamPermissionsRequest", @@ -1890,6 +2223,15 @@ } }, "type": "object" + }, + "ZoneConfiguration": { + "id": "ZoneConfiguration", + "properties": { + "zone": { + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/datafusion/v1beta1/datafusion-gen.go b/datafusion/v1beta1/datafusion-gen.go index 4dfc5b8606..a178c82b34 100644 --- a/datafusion/v1beta1/datafusion-gen.go +++ b/datafusion/v1beta1/datafusion-gen.go @@ -278,6 +278,38 @@ func (s *Accelerator) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// AssetLocation: Provides the mapping of a cloud asset to a direct physical +// location or to a proxy that defines the location on its behalf. +type AssetLocation struct { + // Expected: Defines the customer expectation around ZI/ZS for this asset and + // ZI/ZS state of the region at the time of asset creation. + Expected *IsolationExpectations `json:"expected,omitempty"` + // ExtraParameters: Defines extra parameters required for specific asset types. + ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` + // LocationData: Contains all kinds of physical location definitions for this + // asset. + LocationData []*LocationData `json:"locationData,omitempty"` + // ParentAsset: Defines parents assets if any in order to allow later + // generation of child_asset_location data via child assets. + ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` + // ForceSendFields is a list of field names (e.g. "Expected") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Expected") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *AssetLocation) MarshalJSON() ([]byte, error) { + type NoMethod AssetLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must have one @@ -453,10 +485,73 @@ func (s *Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// BlobstoreLocation: Policy ID that identified data placement in Blobstore as +// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains +type BlobstoreLocation struct { + PolicyId []string `json:"policyId,omitempty"` + // ForceSendFields is a list of field names (e.g. "PolicyId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PolicyId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *BlobstoreLocation) MarshalJSON() ([]byte, error) { + type NoMethod BlobstoreLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } +type CloudAsset struct { + AssetName string `json:"assetName,omitempty"` + AssetType string `json:"assetType,omitempty"` + // ForceSendFields is a list of field names (e.g. "AssetName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AssetName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *CloudAsset) MarshalJSON() ([]byte, error) { + type NoMethod CloudAsset + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +type CloudAssetComposition struct { + ChildAsset []*CloudAsset `json:"childAsset,omitempty"` + // ForceSendFields is a list of field names (e.g. "ChildAsset") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ChildAsset") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *CloudAssetComposition) MarshalJSON() ([]byte, error) { + type NoMethod CloudAssetComposition + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // CryptoKeyConfig: The crypto key configuration. This field is used by the // Customer-managed encryption keys (CMEK) feature. type CryptoKeyConfig struct { @@ -482,6 +577,26 @@ func (s *CryptoKeyConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type DirectLocationAssignment struct { + Location []*LocationAssignment `json:"location,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Location") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *DirectLocationAssignment) MarshalJSON() ([]byte, error) { + type NoMethod DirectLocationAssignment + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // DnsPeering: DNS peering configuration. These configurations are used to // create DNS peering with the customer Cloud DNS. type DnsPeering struct { @@ -602,6 +717,30 @@ func (s *Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// ExtraParameter: Defines parameters that should only be used for specific +// asset types. +type ExtraParameter struct { + // RegionalMigDistributionPolicy: Details about zones used by regional + // compute.googleapis.com/InstanceGroupManager to create instances. + RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "RegionalMigDistributionPolicy") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") + // to include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *ExtraParameter) MarshalJSON() ([]byte, error) { + type NoMethod ExtraParameter + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // IAMPolicy: IAMPolicy encapsulates the IAM policy name, definition and status // of policy fetching. type IAMPolicy struct { @@ -775,6 +914,78 @@ func (s *Instance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type IsolationExpectations struct { + // Possible values: + // "ZI_UNSPECIFIED" + // "ZI_UNKNOWN" - To be used if tracking is not available + // "ZI_NOT_REQUIRED" + // "ZI_PREFERRED" + // "ZI_REQUIRED" + ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` + // Possible values: + // "ZI_REGION_POLICY_UNSPECIFIED" + // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available + // "ZI_REGION_POLICY_NOT_SET" + // "ZI_REGION_POLICY_FAIL_OPEN" + // "ZI_REGION_POLICY_FAIL_CLOSED" + ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` + // Possible values: + // "ZI_REGION_UNSPECIFIED" + // "ZI_REGION_UNKNOWN" - To be used if tracking is not available + // "ZI_REGION_NOT_ENABLED" + // "ZI_REGION_ENABLED" + ZiRegionState string `json:"ziRegionState,omitempty"` + // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and + // zi_region_state instead for setting ZI expectations as per + // go/zicy-publish-physical-location. + // + // Possible values: + // "ZI_UNSPECIFIED" + // "ZI_UNKNOWN" - To be used if tracking is not available + // "ZI_NOT_REQUIRED" + // "ZI_PREFERRED" + // "ZI_REQUIRED" + ZoneIsolation string `json:"zoneIsolation,omitempty"` + // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead + // for setting Zs expectations as per go/zicy-publish-physical-location. + // + // Possible values: + // "ZS_UNSPECIFIED" + // "ZS_UNKNOWN" - To be used if tracking is not available + // "ZS_NOT_REQUIRED" + // "ZS_REQUIRED" + ZoneSeparation string `json:"zoneSeparation,omitempty"` + // Possible values: + // "ZS_UNSPECIFIED" + // "ZS_UNKNOWN" - To be used if tracking is not available + // "ZS_NOT_REQUIRED" + // "ZS_REQUIRED" + ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` + // Possible values: + // "ZS_REGION_UNSPECIFIED" + // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not + // available + // "ZS_REGION_NOT_ENABLED" + // "ZS_REGION_ENABLED" + ZsRegionState string `json:"zsRegionState,omitempty"` + // ForceSendFields is a list of field names (e.g. "ZiOrgPolicy") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ZiOrgPolicy") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *IsolationExpectations) MarshalJSON() ([]byte, error) { + type NoMethod IsolationExpectations + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // ListAvailableVersionsResponse: Response message for the list available // versions request. type ListAvailableVersionsResponse struct { @@ -984,6 +1195,62 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type LocationAssignment struct { + Location string `json:"location,omitempty"` + // Possible values: + // "UNSPECIFIED" + // "CLUSTER" - 1-10: Physical failure domains. + // "POP" + // "CLOUD_ZONE" - 11-20: Logical failure domains. + // "CLOUD_REGION" + // "MULTI_REGION_GEO" + // "MULTI_REGION_JURISDICTION" + // "GLOBAL" + // "OTHER" + LocationType string `json:"locationType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Location") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *LocationAssignment) MarshalJSON() ([]byte, error) { + type NoMethod LocationAssignment + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +type LocationData struct { + BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` + ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` + DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` + GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` + PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` + SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` + // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *LocationData) MarshalJSON() ([]byte, error) { + type NoMethod LocationData + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // MaintenancePolicy: Maintenance policy of the instance. type MaintenancePolicy struct { // MaintenanceExclusionWindow: Optional. The maintenance exclusion window of @@ -1202,6 +1469,30 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// PlacerLocation: Message describing that the location of the customer +// resource is tied to placer allocations +type PlacerLocation struct { + // PlacerConfig: Directory with a config related to it in placer (e.g. + // "/placer/prod/home/my-root/my-dir") + PlacerConfig string `json:"placerConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "PlacerConfig") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PlacerConfig") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *PlacerLocation) MarshalJSON() ([]byte, error) { + type NoMethod PlacerLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Policy: An Identity and Access Management (IAM) policy, which specifies // access controls for Google Cloud resources. A `Policy` is a collection of // `bindings`. A `binding` binds one or more `members`, or principals, to a @@ -1370,6 +1661,33 @@ func (s *RecurringTimeWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// RegionalMigDistributionPolicy: To be used for specifying the intended +// distribution of regional compute.googleapis.com/InstanceGroupManager +// instances +type RegionalMigDistributionPolicy struct { + // TargetShape: The shape in which the group converges around distribution of + // resources. Instance of proto2 enum + TargetShape int64 `json:"targetShape,omitempty"` + // Zones: Cloud zones used by regional MIG to create instances. + Zones []*ZoneConfiguration `json:"zones,omitempty"` + // ForceSendFields is a list of field names (e.g. "TargetShape") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "TargetShape") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { + type NoMethod RegionalMigDistributionPolicy + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // RemoveIamPolicyRequest: Request message for RemoveIamPolicy method. type RemoveIamPolicyRequest struct { } @@ -1414,6 +1732,30 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type SpannerLocation struct { + // BackupName: Set of backups used by the resource with name in the same format + // as what is available at http://table/spanner_automon.backup_metadata + BackupName []string `json:"backupName,omitempty"` + // DbName: Set of databases used by the resource in format /span// + DbName []string `json:"dbName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *SpannerLocation) MarshalJSON() ([]byte, error) { + type NoMethod SpannerLocation + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Status: 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 @@ -1448,6 +1790,26 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type TenantProjectProxy struct { + ProjectNumbers []string `json:"projectNumbers,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ProjectNumbers") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *TenantProjectProxy) MarshalJSON() ([]byte, error) { + type NoMethod TenantProjectProxy + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // TestIamPermissionsRequest: Request message for `TestIamPermissions` method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. Permissions @@ -1570,6 +1932,26 @@ func (s *Version) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +type ZoneConfiguration struct { + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Zone") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *ZoneConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod ZoneConfiguration + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + type ProjectsLocationsGetCall struct { s *Service name string diff --git a/datamigration/v1/datamigration-api.json b/datamigration/v1/datamigration-api.json index e4394c4287..59abdccae8 100644 --- a/datamigration/v1/datamigration-api.json +++ b/datamigration/v1/datamigration-api.json @@ -2125,7 +2125,7 @@ } } }, - "revision": "20240609", + "revision": "20240628", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AlloyDbConnectionProfile": { @@ -4479,8 +4479,7 @@ "PROMOTE_IN_PROGRESS", "WAITING_FOR_SOURCE_WRITES_TO_STOP", "PREPARING_THE_DUMP", - "READY_FOR_PROMOTE", - "DIFF_BACKUP" + "READY_FOR_PROMOTE" ], "enumDescriptions": [ "The phase of the migration job is unknown.", @@ -4489,8 +4488,7 @@ "The migration job is running the promote phase.", "Only RDS flow - waiting for source writes to stop", "Only RDS flow - the sources writes stopped, waiting for dump to begin", - "The migration job is ready to be promoted.", - "The migration job is in the differential backup phase." + "The migration job is ready to be promoted." ], "readOnly": true, "type": "string" diff --git a/datamigration/v1/datamigration-gen.go b/datamigration/v1/datamigration-gen.go index 52155d73c8..54dd2987c8 100644 --- a/datamigration/v1/datamigration-gen.go +++ b/datamigration/v1/datamigration-gen.go @@ -2813,7 +2813,6 @@ type MigrationJob struct { // "PREPARING_THE_DUMP" - Only RDS flow - the sources writes stopped, waiting // for dump to begin // "READY_FOR_PROMOTE" - The migration job is ready to be promoted. - // "DIFF_BACKUP" - The migration job is in the differential backup phase. Phase string `json:"phase,omitempty"` // ReverseSshConnectivity: The details needed to communicate to the source over // Reverse SSH tunnel connectivity. diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index b5d600fcee..cbc16f7f7c 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -176,7 +176,7 @@ ] }, "lookupEntry": { - "description": "Looks up a single entry.", + "description": "Looks up a single Entry by name using the permission on the source system.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:lookupEntry", "httpMethod": "GET", "id": "dataplex.projects.locations.lookupEntry", @@ -185,7 +185,7 @@ ], "parameters": { "aspectTypes": { - "description": "Optional. Limits the aspects returned to the provided aspect types. Only works if the CUSTOM view is selected.", + "description": "Optional. Limits the aspects returned to the provided aspect types. It only works for CUSTOM view.", "location": "query", "repeated": true, "type": "string" @@ -203,13 +203,13 @@ "type": "string" }, "paths": { - "description": "Optional. Limits the aspects returned to those associated with the provided paths within the Entry. Only works if the CUSTOM view is selected.", + "description": "Optional. Limits the aspects returned to those associated with the provided paths within the Entry. It only works for CUSTOM view.", "location": "query", "repeated": true, "type": "string" }, "view": { - "description": "Optional. View for controlling which parts of an entry are to be returned.", + "description": "Optional. View to control which parts of an entry the service should return.", "enum": [ "ENTRY_VIEW_UNSPECIFIED", "BASIC", @@ -221,8 +221,8 @@ "Unspecified EntryView. Defaults to FULL.", "Returns entry only, without aspects.", "Returns all required aspects as well as the keys of all non-required aspects.", - "Returns aspects matching custom fields in GetEntryRequest. If the number of aspects would exceed 100, the first 100 will be returned.", - "Returns all aspects. If the number of aspects would exceed 100, the first 100 will be returned." + "Returns aspects matching custom fields in GetEntryRequest. If the number of aspects exceeds 100, the first 100 will be returned.", + "Returns all aspects. If the number of aspects exceeds 100, the first 100 will be returned." ], "location": "query", "type": "string" @@ -237,7 +237,7 @@ ] }, "searchEntries": { - "description": "Searches for entries matching given query and scope.", + "description": "Searches for Entries matching the given query and scope.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchEntries", "httpMethod": "POST", "id": "dataplex.projects.locations.searchEntries", @@ -253,17 +253,18 @@ "type": "string" }, "orderBy": { - "description": "Optional. Ordering of the results. Supported options to be added later.", + "description": "Optional. Specifies the ordering of results.", "location": "query", "type": "string" }, "pageSize": { - "description": "Optional. Pagination.", + "description": "Optional. Number of results in the search page. If \u003c=0, then defaults to 10. Max limit for page_size is 1000. Throws an invalid argument for page_size \u003e 1000.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { + "description": "Optional. Page token received from a previous SearchEntries call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" }, @@ -273,7 +274,7 @@ "type": "string" }, "scope": { - "description": "Optional. The scope under which the search should be operating. Should either be organizations/ or projects/. If left unspecified, it will default to the organization where the project provided in name is located.", + "description": "Optional. The scope under which the search should be operating. It must either be organizations/ or projects/. If it is unspecified, it defaults to the organization where the project provided in name is located.", "location": "query", "type": "string" } @@ -291,7 +292,7 @@ "aspectTypes": { "methods": { "create": { - "description": "Creates an AspectType", + "description": "Creates an AspectType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes", "httpMethod": "POST", "id": "dataplex.projects.locations.aspectTypes.create", @@ -305,14 +306,14 @@ "type": "string" }, "parent": { - "description": "Required. The resource name of the AspectType, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", + "description": "Required. The resource name of the AspectType, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a Google Cloud region.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" }, "validateOnly": { - "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + "description": "Optional. The service validates the request without performing any mutations. The default is false.", "location": "query", "type": "boolean" } @@ -329,7 +330,7 @@ ] }, "delete": { - "description": "Deletes a AspectType resource.", + "description": "Deletes an AspectType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}", "httpMethod": "DELETE", "id": "dataplex.projects.locations.aspectTypes.delete", @@ -338,7 +339,7 @@ ], "parameters": { "etag": { - "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteAspectTypeRequest method returns an ABORTED error response", + "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteAspectTypeRequest method returns an ABORTED error response.", "location": "query", "type": "string" }, @@ -359,7 +360,7 @@ ] }, "get": { - "description": "Retrieves a AspectType resource.", + "description": "Gets an AspectType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}", "httpMethod": "GET", "id": "dataplex.projects.locations.aspectTypes.get", @@ -424,28 +425,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filter request. Filters are case-sensitive. The following formats are supported:labels.key1 = \"value1\" labels:key1 name = \"value\" These restrictions can be coinjoined with AND, OR and NOT conjunctions.", + "description": "Optional. Filter request. Filters are case-sensitive. The service supports the following formats: labels.key1 = \"value1\" labels:key1 name = \"value\"These restrictions can be conjoined with AND, OR, and NOT conjunctions.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Order by fields (name or create_time) for the result. If not specified, the ordering is undefined.", + "description": "Optional. Orders the result by name or create_time fields. If not specified, the ordering is undefined.", "location": "query", "type": "string" }, "pageSize": { - "description": "Optional. Maximum number of AspectTypes to return. The service may return fewer than this value. If unspecified, at most 10 AspectTypes will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "description": "Optional. Maximum number of AspectTypes to return. The service may return fewer than this value. If unspecified, the service returns at most 10 AspectTypes. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous ListAspectTypes call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAspectTypes must match the call that provided the page token.", + "description": "Optional. Page token received from a previous ListAspectTypes call. Provide this to retrieve the subsequent page. When paginating, all other parameters you provide to ListAspectTypes must match the call that provided the page token.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The resource name of the AspectType location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", + "description": "Required. The resource name of the AspectType location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a Google Cloud region.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -461,7 +462,7 @@ ] }, "patch": { - "description": "Updates a AspectType resource.", + "description": "Updates an AspectType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aspectTypes/{aspectTypesId}", "httpMethod": "PATCH", "id": "dataplex.projects.locations.aspectTypes.patch", @@ -1819,7 +1820,7 @@ "entryGroups": { "methods": { "create": { - "description": "Creates an EntryGroup", + "description": "Creates an EntryGroup.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups", "httpMethod": "POST", "id": "dataplex.projects.locations.entryGroups.create", @@ -1840,7 +1841,7 @@ "type": "string" }, "validateOnly": { - "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + "description": "Optional. The service validates the request without performing any mutations. The default is false.", "location": "query", "type": "boolean" } @@ -1857,7 +1858,7 @@ ] }, "delete": { - "description": "Deletes a EntryGroup resource.", + "description": "Deletes an EntryGroup.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}", "httpMethod": "DELETE", "id": "dataplex.projects.locations.entryGroups.delete", @@ -1866,7 +1867,7 @@ ], "parameters": { "etag": { - "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteEntryGroupRequest method returns an ABORTED error response", + "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteEntryGroupRequest method returns an ABORTED error response.", "location": "query", "type": "string" }, @@ -1887,7 +1888,7 @@ ] }, "get": { - "description": "Retrieves a EntryGroup resource.", + "description": "Gets an EntryGroup.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}", "httpMethod": "GET", "id": "dataplex.projects.locations.entryGroups.get", @@ -1962,18 +1963,18 @@ "type": "string" }, "pageSize": { - "description": "Optional. Maximum number of EntryGroups to return. The service may return fewer than this value. If unspecified, at most 10 EntryGroups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "description": "Optional. Maximum number of EntryGroups to return. The service may return fewer than this value. If unspecified, the service returns at most 10 EntryGroups. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous ListEntryGroups call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListEntryGroups must match the call that provided the page token.", + "description": "Optional. Page token received from a previous ListEntryGroups call. Provide this to retrieve the subsequent page. When paginating, all other parameters you provide to ListEntryGroups must match the call that provided the page token.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The resource name of the entryGroup location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", + "description": "Required. The resource name of the entryGroup location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a Google Cloud region.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1989,7 +1990,7 @@ ] }, "patch": { - "description": "Updates a EntryGroup resource.", + "description": "Updates an EntryGroup.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}", "httpMethod": "PATCH", "id": "dataplex.projects.locations.entryGroups.patch", @@ -2011,7 +2012,7 @@ "type": "string" }, "validateOnly": { - "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + "description": "Optional. The service validates the request, without performing any mutations. The default is false.", "location": "query", "type": "boolean" } @@ -2097,7 +2098,7 @@ ], "parameters": { "entryId": { - "description": "Required. Entry identifier. It has to be unique within an Entry Group.Entries corresponding to Google Cloud resources use Entry ID format based on Full Resource Names (https://cloud.google.com/apis/design/resource_names#full_resource_name). The format is a Full Resource Name of the resource without the prefix double slashes in the API Service Name part of Full Resource Name. This allows retrieval of entries using their associated resource name.For example if the Full Resource Name of a resource is //library.googleapis.com/shelves/shelf1/books/book2, then the suggested entry_id is library.googleapis.com/shelves/shelf1/books/book2.It is also suggested to follow the same convention for entries corresponding to resources from other providers or systems than Google Cloud.The maximum size of the field is 4000 characters.", + "description": "Required. Entry identifier. It has to be unique within an Entry Group.Entries corresponding to Google Cloud resources use an Entry ID format based on full resource names (https://cloud.google.com/apis/design/resource_names#full_resource_name). The format is a full resource name of the resource without the prefix double slashes in the API service name part of the full resource name. This allows retrieval of entries using their associated resource name.For example, if the full resource name of a resource is //library.googleapis.com/shelves/shelf1/books/book2, then the suggested entry_id is library.googleapis.com/shelves/shelf1/books/book2.It is also suggested to follow the same convention for entries corresponding to resources from providers or systems other than Google Cloud.The maximum size of the field is 4000 characters.", "location": "query", "type": "string" }, @@ -2146,7 +2147,7 @@ ] }, "get": { - "description": "Gets a single entry.", + "description": "Gets an Entry.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}/entries/{entriesId}", "httpMethod": "GET", "id": "dataplex.projects.locations.entryGroups.entries.get", @@ -2155,7 +2156,7 @@ ], "parameters": { "aspectTypes": { - "description": "Optional. Limits the aspects returned to the provided aspect types. Only works if the CUSTOM view is selected.", + "description": "Optional. Limits the aspects returned to the provided aspect types. It only works for CUSTOM view.", "location": "query", "repeated": true, "type": "string" @@ -2168,13 +2169,13 @@ "type": "string" }, "paths": { - "description": "Optional. Limits the aspects returned to those associated with the provided paths within the Entry. Only works if the CUSTOM view is selected.", + "description": "Optional. Limits the aspects returned to those associated with the provided paths within the Entry. It only works for CUSTOM view.", "location": "query", "repeated": true, "type": "string" }, "view": { - "description": "Optional. View for controlling which parts of an entry are to be returned.", + "description": "Optional. View to control which parts of an entry the service should return.", "enum": [ "ENTRY_VIEW_UNSPECIFIED", "BASIC", @@ -2186,8 +2187,8 @@ "Unspecified EntryView. Defaults to FULL.", "Returns entry only, without aspects.", "Returns all required aspects as well as the keys of all non-required aspects.", - "Returns aspects matching custom fields in GetEntryRequest. If the number of aspects would exceed 100, the first 100 will be returned.", - "Returns all aspects. If the number of aspects would exceed 100, the first 100 will be returned." + "Returns aspects matching custom fields in GetEntryRequest. If the number of aspects exceeds 100, the first 100 will be returned.", + "Returns all aspects. If the number of aspects exceeds 100, the first 100 will be returned." ], "location": "query", "type": "string" @@ -2202,7 +2203,7 @@ ] }, "list": { - "description": "Lists entries within an entry group.", + "description": "Lists Entries within an EntryGroup.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}/entries", "httpMethod": "GET", "id": "dataplex.projects.locations.entryGroups.entries.list", @@ -2211,17 +2212,18 @@ ], "parameters": { "filter": { - "description": "Optional. A filter on the entries to return. Filters are case-sensitive. The request can be filtered by the following fields: entry_type, entry_source.display_name. The comparison operators are =, !=, \u003c, \u003e, \u003c=, \u003e= (strings are compared according to lexical order) The logical operators AND, OR, NOT can be used in the filter. Wildcard \"*\" can be used, but for entry_type the full project id or number needs to be provided. Example filter expressions: \"entry_source.display_name=AnExampleDisplayName\" \"entry_type=projects/example-project/locations/global/entryTypes/example-entry_type\" \"entry_type=projects/example-project/locations/us/entryTypes/a* OR entry_type=projects/another-project/locations/*\" \"NOT entry_source.display_name=AnotherExampleDisplayName\"", + "description": "Optional. A filter on the entries to return. Filters are case-sensitive. You can filter the request by the following fields: entry_type entry_source.display_nameThe comparison operators are =, !=, \u003c, \u003e, \u003c=, \u003e=. The service compares strings according to lexical order.You can use the logical operators AND, OR, NOT in the filter.You can use Wildcard \"*\", but for entry_type you need to provide the full project id or number.Example filter expressions: \"entry_source.display_name=AnExampleDisplayName\" \"entry_type=projects/example-project/locations/global/entryTypes/example-entry_type\" \"entry_type=projects/example-project/locations/us/entryTypes/a* OR entry_type=projects/another-project/locations/*\" \"NOT entry_source.display_name=AnotherExampleDisplayName\"", "location": "query", "type": "string" }, "pageSize": { + "description": "Optional. Number of items to return per page. If there are remaining results, the service returns a next_page_token. If unspecified, the service returns at most 10 Entries. The maximum value is 100; values above 100 will be coerced to 100.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. The pagination token returned by a previous request.", + "description": "Optional. Page token received from a previous ListEntries call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" }, @@ -2251,18 +2253,18 @@ ], "parameters": { "allowMissing": { - "description": "Optional. If set to true and the entry does not exist, it will be created.", + "description": "Optional. If set to true and the entry doesn't exist, the service will create it.", "location": "query", "type": "boolean" }, "aspectKeys": { - "description": "Optional. The map keys of the Aspects which should be modified. Supports the following syntaxes: * - matches aspect on given type and empty path * @path - matches aspect on given type and specified path * * - matches aspects on given type for all paths * *@path - matches aspects of all types on the given pathExisting aspects matching the syntax will not be removed unless delete_missing_aspects is set to true.If this field is left empty, it will be treated as specifying exactly those Aspects present in the request.", + "description": "Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. * - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.", "location": "query", "repeated": true, "type": "string" }, "deleteMissingAspects": { - "description": "Optional. If set to true and the aspect_keys specify aspect ranges, any existing aspects from that range not provided in the request will be deleted.", + "description": "Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.", "location": "query", "type": "boolean" }, @@ -2274,7 +2276,7 @@ "type": "string" }, "updateMask": { - "description": "Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value \"aspects\".If the update_mask is empty, all modifiable fields present in the request will be updated.", + "description": "Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value \"aspects\".If the update_mask is empty, the service will update all modifiable fields present in the request.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -2298,7 +2300,7 @@ "entryTypes": { "methods": { "create": { - "description": "Creates an EntryType", + "description": "Creates an EntryType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes", "httpMethod": "POST", "id": "dataplex.projects.locations.entryTypes.create", @@ -2312,14 +2314,14 @@ "type": "string" }, "parent": { - "description": "Required. The resource name of the EntryType, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", + "description": "Required. The resource name of the EntryType, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a Google Cloud region.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" }, "validateOnly": { - "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + "description": "Optional. The service validates the request without performing any mutations. The default is false.", "location": "query", "type": "boolean" } @@ -2336,7 +2338,7 @@ ] }, "delete": { - "description": "Deletes a EntryType resource.", + "description": "Deletes an EntryType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}", "httpMethod": "DELETE", "id": "dataplex.projects.locations.entryTypes.delete", @@ -2345,7 +2347,7 @@ ], "parameters": { "etag": { - "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteEntryTypeRequest method returns an ABORTED error response", + "description": "Optional. If the client provided etag value does not match the current etag value, the DeleteEntryTypeRequest method returns an ABORTED error response.", "location": "query", "type": "string" }, @@ -2366,7 +2368,7 @@ ] }, "get": { - "description": "Retrieves a EntryType resource.", + "description": "Gets an EntryType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}", "httpMethod": "GET", "id": "dataplex.projects.locations.entryTypes.get", @@ -2431,28 +2433,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filter request. Filters are case-sensitive. The following formats are supported:labels.key1 = \"value1\" labels:key1 name = \"value\" These restrictions can be coinjoined with AND, OR and NOT conjunctions.", + "description": "Optional. Filter request. Filters are case-sensitive. The service supports the following formats: labels.key1 = \"value1\" labels:key1 name = \"value\"These restrictions can be conjoined with AND, OR, and NOT conjunctions.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Order by fields (name or create_time) for the result. If not specified, the ordering is undefined.", + "description": "Optional. Orders the result by name or create_time fields. If not specified, the ordering is undefined.", "location": "query", "type": "string" }, "pageSize": { - "description": "Optional. Maximum number of EntryTypes to return. The service may return fewer than this value. If unspecified, at most 10 EntryTypes will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "description": "Optional. Maximum number of EntryTypes to return. The service may return fewer than this value. If unspecified, the service returns at most 10 EntryTypes. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous ListEntryTypes call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListEntryTypes must match the call that provided the page token.", + "description": "Optional. Page token received from a previous ListEntryTypes call. Provide this to retrieve the subsequent page. When paginating, all other parameters you provided to ListEntryTypes must match the call that provided the page token.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The resource name of the EntryType location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a GCP region.", + "description": "Required. The resource name of the EntryType location, of the form: projects/{project_number}/locations/{location_id} where location_id refers to a Google Cloud region.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2468,7 +2470,7 @@ ] }, "patch": { - "description": "Updates a EntryType resource.", + "description": "Updates an EntryType.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryTypes/{entryTypesId}", "httpMethod": "PATCH", "id": "dataplex.projects.locations.entryTypes.patch", @@ -2490,7 +2492,7 @@ "type": "string" }, "validateOnly": { - "description": "Optional. Only validate the request, but do not perform mutations. The default is false.", + "description": "Optional. The service validates the request without performing any mutations. The default is false.", "location": "query", "type": "boolean" } @@ -5271,7 +5273,7 @@ } } }, - "revision": "20240611", + "revision": "20240624", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -5512,7 +5514,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Required. The content of the aspect, according to its aspect type schema. This will replace content. The maximum size of the field is 120KB (encoded as UTF-8).", + "description": "Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).", "type": "object" }, "path": { @@ -5530,7 +5532,7 @@ "type": "object" }, "GoogleCloudDataplexV1AspectSource": { - "description": "AspectSource contains source system related information for the aspect.", + "description": "AspectSource contains information related to the source system of the Aspect.", "id": "GoogleCloudDataplexV1AspectSource", "properties": { "createTime": { @@ -5547,12 +5549,12 @@ "type": "object" }, "GoogleCloudDataplexV1AspectType": { - "description": "Aspect Type is a template for creating Aspects, and represents the JSON-schema for a given Entry, e.g., BigQuery Table Schema.", + "description": "AspectType is a template for creating Aspects, and represents the JSON-schema for a given Entry, for example, BigQuery Table Schema.", "id": "GoogleCloudDataplexV1AspectType", "properties": { "authorization": { "$ref": "GoogleCloudDataplexV1AspectTypeAuthorization", - "description": "Immutable. Authorization defined for this type." + "description": "Immutable. Defines the Authorization for this type." }, "createTime": { "description": "Output only. The time when the AspectType was created.", @@ -5569,7 +5571,7 @@ "type": "string" }, "etag": { - "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", + "description": "The service computes this checksum. The client may send it on update and delete requests to ensure it has an up-to-date value before proceeding.", "type": "string" }, "labels": { @@ -5588,23 +5590,8 @@ "readOnly": true, "type": "string" }, - "transferStatus": { - "description": "Output only. Denotes the transfer status of the Aspect Type. It is unspecified for Aspect Types created from Dataplex API.", - "enum": [ - "TRANSFER_STATUS_UNSPECIFIED", - "TRANSFER_STATUS_MIGRATED", - "TRANSFER_STATUS_TRANSFERRED" - ], - "enumDescriptions": [ - "The default value. It is set for resources that were not subject for migration from Data Catalog service.", - "Indicates that a resource was migrated from Data Catalog service but it hasn't been transferred yet. In particular the resource cannot be updated from Dataplex API.", - "Indicates that a resource was transferred from Data Catalog service. The resource can only be updated from Dataplex API." - ], - "readOnly": true, - "type": "string" - }, "uid": { - "description": "Output only. System generated globally unique ID for the AspectType. This ID will be different if the AspectType is deleted and re-created with the same name.", + "description": "Output only. System generated globally unique ID for the AspectType. If you delete and recreate the AspectType with the same name, then this ID will be different.", "readOnly": true, "type": "string" }, @@ -5618,18 +5605,18 @@ "type": "object" }, "GoogleCloudDataplexV1AspectTypeAuthorization": { - "description": "Autorization for an Aspect Type.", + "description": "Autorization for an AspectType.", "id": "GoogleCloudDataplexV1AspectTypeAuthorization", "properties": { "alternateUsePermission": { - "description": "Immutable. The IAM permission grantable on the Entry Group to allow access to instantiate Aspects of Dataplex owned Aspect Types, only settable for Dataplex owned Types.", + "description": "Immutable. The IAM permission grantable on the EntryGroup to allow access to instantiate Aspects of Dataplex owned AspectTypes, only settable for Dataplex owned Types.", "type": "string" } }, "type": "object" }, "GoogleCloudDataplexV1AspectTypeMetadataTemplate": { - "description": "MetadataTemplate definition for AspectType", + "description": "MetadataTemplate definition for an AspectType.", "id": "GoogleCloudDataplexV1AspectTypeMetadataTemplate", "properties": { "annotations": { @@ -5638,14 +5625,14 @@ }, "arrayItems": { "$ref": "GoogleCloudDataplexV1AspectTypeMetadataTemplate", - "description": "Optional. array_items needs to be set if the type is array. array_items can refer to a primitive field or a complex (record only) field. To specify a primitive field, just name and type needs to be set in the nested MetadataTemplate. The recommended value for the name field is item, as this is not used in the actual payload." + "description": "Optional. If the type is array, set array_items. array_items can refer to a primitive field or a complex (record only) field. To specify a primitive field, you only need to set name and type in the nested MetadataTemplate. The recommended value for the name field is item, as this isn't used in the actual payload." }, "constraints": { "$ref": "GoogleCloudDataplexV1AspectTypeMetadataTemplateConstraints", "description": "Optional. Specifies the constraints on this field." }, "enumValues": { - "description": "Optional. The list of values for an enum type. Needs to be defined if the type is enum.", + "description": "Optional. The list of values for an enum type. You must define it if the type is enum.", "items": { "$ref": "GoogleCloudDataplexV1AspectTypeMetadataTemplateEnumValue" }, @@ -5658,61 +5645,61 @@ }, "mapItems": { "$ref": "GoogleCloudDataplexV1AspectTypeMetadataTemplate", - "description": "Optional. map_items needs to be set if the type is map. map_items can refer to a primitive field or a complex (record only) field. To specify a primitive field, just name and type needs to be set in the nested MetadataTemplate. The recommended value for the name field is item, as this is not used in the actual payload." + "description": "Optional. If the type is map, set map_items. map_items can refer to a primitive field or a complex (record only) field. To specify a primitive field, you only need to set name and type in the nested MetadataTemplate. The recommended value for the name field is item, as this isn't used in the actual payload." }, "name": { "description": "Required. The name of the field.", "type": "string" }, "recordFields": { - "description": "Optional. Field definition, needs to be specified if the type is record. Defines the nested fields.", + "description": "Optional. Field definition. You must specify it if the type is record. It defines the nested fields.", "items": { "$ref": "GoogleCloudDataplexV1AspectTypeMetadataTemplate" }, "type": "array" }, "type": { - "description": "Required. The datatype of this field. The following values are supported: Primitive types (string, integer, boolean, double, datetime); datetime must be of the format RFC3339 UTC \"Zulu\" (Examples: \"2014-10-02T15:01:23Z\" and \"2014-10-02T15:01:23.045123456Z\"). Complex types (enum, array, map, record).", + "description": "Required. The datatype of this field. The following values are supported:Primitive types: string integer boolean double datetime. Must be of the format RFC3339 UTC \"Zulu\" (Examples: \"2014-10-02T15:01:23Z\" and \"2014-10-02T15:01:23.045123456Z\").Complex types: enum array map record", "type": "string" }, "typeId": { - "description": "Optional. Id can be used if this definition of the field needs to be reused later. Id needs to be unique across the entire template. Id can only be specified if the field type is record.", + "description": "Optional. You can use type id if this definition of the field needs to be reused later. The type id must be unique across the entire template. You can only specify it if the field type is record.", "type": "string" }, "typeRef": { - "description": "Optional. A reference to another field definition (instead of an inline definition). The value must be equal to the value of an id field defined elsewhere in the MetadataTemplate. Only fields with type as record can refer to other fields.", + "description": "Optional. A reference to another field definition (not an inline definition). The value must be equal to the value of an id field defined elsewhere in the MetadataTemplate. Only fields with record type can refer to other fields.", "type": "string" } }, "type": "object" }, "GoogleCloudDataplexV1AspectTypeMetadataTemplateAnnotations": { - "description": "Definition of the annotations of a field", + "description": "Definition of the annotations of a field.", "id": "GoogleCloudDataplexV1AspectTypeMetadataTemplateAnnotations", "properties": { "deprecated": { - "description": "Optional. Marks a field as deprecated, a deprecation message can be included.", + "description": "Optional. Marks a field as deprecated. You can include a deprecation message.", "type": "string" }, "description": { - "description": "Optional. Specify a description for a field", + "description": "Optional. Description for a field.", "type": "string" }, "displayName": { - "description": "Optional. Specify a displayname for a field.", + "description": "Optional. Display name for a field.", "type": "string" }, "displayOrder": { - "description": "Optional. Specify a display order for a field. Display order can be used to reorder where a field is rendered", + "description": "Optional. Display order for a field. You can use this to reorder where a field is rendered.", "format": "int32", "type": "integer" }, "stringType": { - "description": "Optional. String Type annotations can be used to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. url: A fully qualified url link. resource: A service qualified resource reference.", + "description": "Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. url: A fully qualified URL link. resource: A service qualified resource reference.", "type": "string" }, "stringValues": { - "description": "Optional. Suggested hints for string fields. These can be used to suggest values to users, through an UI for example.", + "description": "Optional. Suggested hints for string fields. You can use them to suggest values to users through console.", "items": { "type": "string" }, @@ -5722,31 +5709,31 @@ "type": "object" }, "GoogleCloudDataplexV1AspectTypeMetadataTemplateConstraints": { - "description": "Definition of the constraints of a field", + "description": "Definition of the constraints of a field.", "id": "GoogleCloudDataplexV1AspectTypeMetadataTemplateConstraints", "properties": { "required": { - "description": "Optional. Marks this as an optional/required field.", + "description": "Optional. Marks this field as optional or required.", "type": "boolean" } }, "type": "object" }, "GoogleCloudDataplexV1AspectTypeMetadataTemplateEnumValue": { - "description": "Definition of Enumvalue (to be used by enum fields)", + "description": "Definition of Enumvalue, to be used for enum fields.", "id": "GoogleCloudDataplexV1AspectTypeMetadataTemplateEnumValue", "properties": { "deprecated": { - "description": "Optional. Optional deprecation message to be set if an enum value needs to be deprecated.", + "description": "Optional. You can set this message if you need to deprecate an enum value.", "type": "string" }, "index": { - "description": "Required. Index for the enum. Cannot be modified.", + "description": "Required. Index for the enum value. It can't be modified.", "format": "int32", "type": "integer" }, "name": { - "description": "Required. Name of the enumvalue. This is the actual value that the aspect will contain.", + "description": "Required. Name of the enumvalue. This is the actual value that the aspect can contain.", "type": "string" } }, @@ -7709,6 +7696,12 @@ "description": "A DataScanJob represents an instance of DataScan execution.", "id": "GoogleCloudDataplexV1DataScanJob", "properties": { + "createTime": { + "description": "Output only. The time when the DataScanJob was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "dataProfileResult": { "$ref": "GoogleCloudDataplexV1DataProfileResult", "description": "Output only. The result of the data profile scan.", @@ -8175,7 +8168,7 @@ "additionalProperties": { "$ref": "GoogleCloudDataplexV1Aspect" }, - "description": "Optional. The Aspects attached to the Entry. The format for the key can be one of the following: 1. {projectId}.{locationId}.{aspectTypeId} (if the aspect is attached directly to the entry) 2. {projectId}.{locationId}.{aspectTypeId}@{path} (if the aspect is attached to an entry's path)", + "description": "Optional. The Aspects attached to the Entry. The format for the key can be one of the following: {projectId}.{locationId}.{aspectTypeId} (if the aspect is attached directly to the entry) {projectId}.{locationId}.{aspectTypeId}@{path} (if the aspect is attached to an entry's path)", "type": "object" }, "createTime": { @@ -8186,7 +8179,7 @@ }, "entrySource": { "$ref": "GoogleCloudDataplexV1EntrySource", - "description": "Optional. Source system related information for an entry." + "description": "Optional. Information related to the source system for an entry." }, "entryType": { "description": "Required. Immutable. The resource name of the EntryType used to create this Entry.", @@ -8232,7 +8225,7 @@ "type": "string" }, "etag": { - "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", + "description": "This checksum is computed by the service, and might be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "type": "string" }, "labels": { @@ -8247,23 +8240,8 @@ "readOnly": true, "type": "string" }, - "transferStatus": { - "description": "Output only. Denotes the transfer status of the Entry Group. It is unspecified for Entry Group created from Dataplex API.", - "enum": [ - "TRANSFER_STATUS_UNSPECIFIED", - "TRANSFER_STATUS_MIGRATED", - "TRANSFER_STATUS_TRANSFERRED" - ], - "enumDescriptions": [ - "The default value. It is set for resources that were not subject for migration from Data Catalog service.", - "Indicates that a resource was migrated from Data Catalog service but it hasn't been transferred yet. In particular the resource cannot be updated from Dataplex API.", - "Indicates that a resource was transferred from Data Catalog service. The resource can only be updated from Dataplex API." - ], - "readOnly": true, - "type": "string" - }, "uid": { - "description": "Output only. System generated globally unique ID for the EntryGroup. This ID will be different if the EntryGroup is deleted and re-created with the same name.", + "description": "Output only. System generated globally unique ID for the EntryGroup. If you delete and recreate the EntryGroup with the same name, this ID will be different.", "readOnly": true, "type": "string" }, @@ -8277,7 +8255,7 @@ "type": "object" }, "GoogleCloudDataplexV1EntrySource": { - "description": "EntrySource contains source system related information for the entry.", + "description": "EntrySource contains information related to the source system of the Entry.", "id": "GoogleCloudDataplexV1EntrySource", "properties": { "ancestors": { @@ -8308,7 +8286,7 @@ "type": "object" }, "location": { - "description": "Output only. Location of the resource in the source system. Entry will be searchable by this location. By default, this should match the location of the EntryGroup containing this entry. A different value allows capturing source location for data external to GCP.", + "description": "Output only. Location of the resource in the source system. You can search the Entry by this location. By default, this should match the location of the EntryGroup containing this entry. A different value allows capturing the source location for data external to Google Cloud.", "readOnly": true, "type": "string" }, @@ -8370,7 +8348,7 @@ "type": "string" }, "etag": { - "description": "Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", + "description": "Optional. This checksum is computed by the service, and might be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "type": "string" }, "labels": { @@ -8401,7 +8379,7 @@ "type": "string" }, "typeAliases": { - "description": "Optional. Indicates the class this Entry Type belongs to, for example, TABLE, DATABASE, MODEL.", + "description": "Optional. Indicates the classes this Entry Type belongs to, for example, TABLE, DATABASE, MODEL.", "items": { "type": "string" }, @@ -9090,11 +9068,11 @@ "type": "object" }, "GoogleCloudDataplexV1ListAspectTypesResponse": { - "description": "List AspectTypes response", + "description": "List AspectTypes response.", "id": "GoogleCloudDataplexV1ListAspectTypesResponse", "properties": { "aspectTypes": { - "description": "ListAspectTypes under the given parent location.", + "description": "AspectTypes under the given parent location.", "items": { "$ref": "GoogleCloudDataplexV1AspectType" }, @@ -9105,7 +9083,7 @@ "type": "string" }, "unreachableLocations": { - "description": "Locations that could not be reached.", + "description": "Locations that the service couldn't reach.", "items": { "type": "string" }, @@ -9287,28 +9265,29 @@ "type": "object" }, "GoogleCloudDataplexV1ListEntriesResponse": { + "description": "List Entries response.", "id": "GoogleCloudDataplexV1ListEntriesResponse", "properties": { "entries": { - "description": "The list of entries.", + "description": "The list of entries under the given parent location.", "items": { "$ref": "GoogleCloudDataplexV1Entry" }, "type": "array" }, "nextPageToken": { - "description": "Pagination token.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" } }, "type": "object" }, "GoogleCloudDataplexV1ListEntryGroupsResponse": { - "description": "List ListEntryGroups response.", + "description": "List entry groups response.", "id": "GoogleCloudDataplexV1ListEntryGroupsResponse", "properties": { "entryGroups": { - "description": "ListEntryGroups under the given parent location.", + "description": "Entry groups under the given parent location.", "items": { "$ref": "GoogleCloudDataplexV1EntryGroup" }, @@ -9319,7 +9298,7 @@ "type": "string" }, "unreachableLocations": { - "description": "Locations that could not be reached.", + "description": "Locations that the service couldn't reach.", "items": { "type": "string" }, @@ -9329,11 +9308,11 @@ "type": "object" }, "GoogleCloudDataplexV1ListEntryTypesResponse": { - "description": "List EntryTypes response", + "description": "List EntryTypes response.", "id": "GoogleCloudDataplexV1ListEntryTypesResponse", "properties": { "entryTypes": { - "description": "ListEntryTypes under the given parent location.", + "description": "EntryTypes under the given parent location.", "items": { "$ref": "GoogleCloudDataplexV1EntryType" }, @@ -9344,7 +9323,7 @@ "type": "string" }, "unreachableLocations": { - "description": "Locations that could not be reached.", + "description": "Locations that the service couldn't reach.", "items": { "type": "string" }, @@ -9840,7 +9819,7 @@ "id": "GoogleCloudDataplexV1SearchEntriesResponse", "properties": { "nextPageToken": { - "description": "Pagination token.", + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "results": { @@ -9851,12 +9830,12 @@ "type": "array" }, "totalSize": { - "description": "The estimated total number of matching entries. Not guaranteed to be accurate.", + "description": "The estimated total number of matching entries. This number isn't guaranteed to be accurate.", "format": "int32", "type": "integer" }, "unreachable": { - "description": "Unreachable locations. Search results don't include data from those locations.", + "description": "Locations that the service couldn't reach. Search results don't include data from these locations.", "items": { "type": "string" }, diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index 3f3ad1346c..19638cf927 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -722,8 +722,7 @@ type GoogleCloudDataplexV1Aspect struct { // CreateTime: Output only. The time when the Aspect was created. CreateTime string `json:"createTime,omitempty"` // Data: Required. The content of the aspect, according to its aspect type - // schema. This will replace content. The maximum size of the field is 120KB - // (encoded as UTF-8). + // schema. The maximum size of the field is 120KB (encoded as UTF-8). Data googleapi.RawMessage `json:"data,omitempty"` // Path: Output only. The path in the entry under which the aspect is attached. Path string `json:"path,omitempty"` @@ -747,8 +746,8 @@ func (s *GoogleCloudDataplexV1Aspect) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDataplexV1AspectSource: AspectSource contains source system -// related information for the aspect. +// GoogleCloudDataplexV1AspectSource: AspectSource contains information related +// to the source system of the Aspect. type GoogleCloudDataplexV1AspectSource struct { // CreateTime: The create time of the aspect in the source system. CreateTime string `json:"createTime,omitempty"` @@ -772,11 +771,11 @@ func (s *GoogleCloudDataplexV1AspectSource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDataplexV1AspectType: Aspect Type is a template for creating -// Aspects, and represents the JSON-schema for a given Entry, e.g., BigQuery -// Table Schema. +// GoogleCloudDataplexV1AspectType: AspectType is a template for creating +// Aspects, and represents the JSON-schema for a given Entry, for example, +// BigQuery Table Schema. type GoogleCloudDataplexV1AspectType struct { - // Authorization: Immutable. Authorization defined for this type. + // Authorization: Immutable. Defines the Authorization for this type. Authorization *GoogleCloudDataplexV1AspectTypeAuthorization `json:"authorization,omitempty"` // CreateTime: Output only. The time when the AspectType was created. CreateTime string `json:"createTime,omitempty"` @@ -784,9 +783,8 @@ type GoogleCloudDataplexV1AspectType struct { Description string `json:"description,omitempty"` // DisplayName: Optional. User friendly display name. DisplayName string `json:"displayName,omitempty"` - // Etag: This checksum is computed by the server based on the value of other - // fields, and may be sent on update and delete requests to ensure the client - // has an up-to-date value before proceeding. + // Etag: The service computes this checksum. The client may send it on update + // and delete requests to ensure it has an up-to-date value before proceeding. Etag string `json:"etag,omitempty"` // Labels: Optional. User-defined labels for the AspectType. Labels map[string]string `json:"labels,omitempty"` @@ -797,22 +795,9 @@ type GoogleCloudDataplexV1AspectType struct { // projects/{project_number}/locations/{location_id}/aspectTypes/{aspect_type_id // }. Name string `json:"name,omitempty"` - // TransferStatus: Output only. Denotes the transfer status of the Aspect Type. - // It is unspecified for Aspect Types created from Dataplex API. - // - // Possible values: - // "TRANSFER_STATUS_UNSPECIFIED" - The default value. It is set for resources - // that were not subject for migration from Data Catalog service. - // "TRANSFER_STATUS_MIGRATED" - Indicates that a resource was migrated from - // Data Catalog service but it hasn't been transferred yet. In particular the - // resource cannot be updated from Dataplex API. - // "TRANSFER_STATUS_TRANSFERRED" - Indicates that a resource was transferred - // from Data Catalog service. The resource can only be updated from Dataplex - // API. - TransferStatus string `json:"transferStatus,omitempty"` - // Uid: Output only. System generated globally unique ID for the AspectType. - // This ID will be different if the AspectType is deleted and re-created with - // the same name. + // Uid: Output only. System generated globally unique ID for the AspectType. If + // you delete and recreate the AspectType with the same name, then this ID will + // be different. Uid string `json:"uid,omitempty"` // UpdateTime: Output only. The time when the AspectType was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -837,12 +822,12 @@ func (s *GoogleCloudDataplexV1AspectType) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDataplexV1AspectTypeAuthorization: Autorization for an Aspect -// Type. +// GoogleCloudDataplexV1AspectTypeAuthorization: Autorization for an +// AspectType. type GoogleCloudDataplexV1AspectTypeAuthorization struct { - // AlternateUsePermission: Immutable. The IAM permission grantable on the Entry - // Group to allow access to instantiate Aspects of Dataplex owned Aspect Types, - // only settable for Dataplex owned Types. + // AlternateUsePermission: Immutable. The IAM permission grantable on the + // EntryGroup to allow access to instantiate Aspects of Dataplex owned + // AspectTypes, only settable for Dataplex owned Types. AlternateUsePermission string `json:"alternateUsePermission,omitempty"` // ForceSendFields is a list of field names (e.g. "AlternateUsePermission") to // unconditionally include in API requests. By default, fields with empty or @@ -863,20 +848,20 @@ func (s *GoogleCloudDataplexV1AspectTypeAuthorization) MarshalJSON() ([]byte, er } // GoogleCloudDataplexV1AspectTypeMetadataTemplate: MetadataTemplate definition -// for AspectType +// for an AspectType. type GoogleCloudDataplexV1AspectTypeMetadataTemplate struct { // Annotations: Optional. Specifies annotations on this field. Annotations *GoogleCloudDataplexV1AspectTypeMetadataTemplateAnnotations `json:"annotations,omitempty"` - // ArrayItems: Optional. array_items needs to be set if the type is array. - // array_items can refer to a primitive field or a complex (record only) field. - // To specify a primitive field, just name and type needs to be set in the - // nested MetadataTemplate. The recommended value for the name field is item, - // as this is not used in the actual payload. + // ArrayItems: Optional. If the type is array, set array_items. array_items can + // refer to a primitive field or a complex (record only) field. To specify a + // primitive field, you only need to set name and type in the nested + // MetadataTemplate. The recommended value for the name field is item, as this + // isn't used in the actual payload. ArrayItems *GoogleCloudDataplexV1AspectTypeMetadataTemplate `json:"arrayItems,omitempty"` // Constraints: Optional. Specifies the constraints on this field. Constraints *GoogleCloudDataplexV1AspectTypeMetadataTemplateConstraints `json:"constraints,omitempty"` - // EnumValues: Optional. The list of values for an enum type. Needs to be - // defined if the type is enum. + // EnumValues: Optional. The list of values for an enum type. You must define + // it if the type is enum. EnumValues []*GoogleCloudDataplexV1AspectTypeMetadataTemplateEnumValue `json:"enumValues,omitempty"` // Index: Optional. Index is used to encode Template messages. The value of // index can range between 1 and 2,147,483,647. Index must be unique within all @@ -885,31 +870,30 @@ type GoogleCloudDataplexV1AspectTypeMetadataTemplate struct { // the actual storage format. Index is a mandatory field, but it is optional // for top level fields, and map/array "values" definitions. Index int64 `json:"index,omitempty"` - // MapItems: Optional. map_items needs to be set if the type is map. map_items - // can refer to a primitive field or a complex (record only) field. To specify - // a primitive field, just name and type needs to be set in the nested + // MapItems: Optional. If the type is map, set map_items. map_items can refer + // to a primitive field or a complex (record only) field. To specify a + // primitive field, you only need to set name and type in the nested // MetadataTemplate. The recommended value for the name field is item, as this - // is not used in the actual payload. + // isn't used in the actual payload. MapItems *GoogleCloudDataplexV1AspectTypeMetadataTemplate `json:"mapItems,omitempty"` // Name: Required. The name of the field. Name string `json:"name,omitempty"` - // RecordFields: Optional. Field definition, needs to be specified if the type - // is record. Defines the nested fields. + // RecordFields: Optional. Field definition. You must specify it if the type is + // record. It defines the nested fields. RecordFields []*GoogleCloudDataplexV1AspectTypeMetadataTemplate `json:"recordFields,omitempty"` // Type: Required. The datatype of this field. The following values are - // supported: Primitive types (string, integer, boolean, double, datetime); - // datetime must be of the format RFC3339 UTC "Zulu" (Examples: - // "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"). Complex types - // (enum, array, map, record). + // supported:Primitive types: string integer boolean double datetime. Must be + // of the format RFC3339 UTC "Zulu" (Examples: "2014-10-02T15:01:23Z" and + // "2014-10-02T15:01:23.045123456Z").Complex types: enum array map record Type string `json:"type,omitempty"` - // TypeId: Optional. Id can be used if this definition of the field needs to be - // reused later. Id needs to be unique across the entire template. Id can only - // be specified if the field type is record. + // TypeId: Optional. You can use type id if this definition of the field needs + // to be reused later. The type id must be unique across the entire template. + // You can only specify it if the field type is record. TypeId string `json:"typeId,omitempty"` - // TypeRef: Optional. A reference to another field definition (instead of an - // inline definition). The value must be equal to the value of an id field - // defined elsewhere in the MetadataTemplate. Only fields with type as record - // can refer to other fields. + // TypeRef: Optional. A reference to another field definition (not an inline + // definition). The value must be equal to the value of an id field defined + // elsewhere in the MetadataTemplate. Only fields with record type can refer to + // other fields. TypeRef string `json:"typeRef,omitempty"` // ForceSendFields is a list of field names (e.g. "Annotations") to // unconditionally include in API requests. By default, fields with empty or @@ -930,25 +914,25 @@ func (s *GoogleCloudDataplexV1AspectTypeMetadataTemplate) MarshalJSON() ([]byte, } // GoogleCloudDataplexV1AspectTypeMetadataTemplateAnnotations: Definition of -// the annotations of a field +// the annotations of a field. type GoogleCloudDataplexV1AspectTypeMetadataTemplateAnnotations struct { - // Deprecated -- Optional. Marks a field as deprecated, a deprecation message - // can be included. + // Deprecated -- Optional. Marks a field as deprecated. You can include a + // deprecation message. Deprecated string `json:"deprecated,omitempty"` - // Description: Optional. Specify a description for a field + // Description: Optional. Description for a field. Description string `json:"description,omitempty"` - // DisplayName: Optional. Specify a displayname for a field. + // DisplayName: Optional. Display name for a field. DisplayName string `json:"displayName,omitempty"` - // DisplayOrder: Optional. Specify a display order for a field. Display order - // can be used to reorder where a field is rendered + // DisplayOrder: Optional. Display order for a field. You can use this to + // reorder where a field is rendered. DisplayOrder int64 `json:"displayOrder,omitempty"` - // StringType: Optional. String Type annotations can be used to specify special + // StringType: Optional. You can use String Type annotations to specify special // meaning to string fields. The following values are supported: richText: The - // field must be interpreted as a rich text field. url: A fully qualified url + // field must be interpreted as a rich text field. url: A fully qualified URL // link. resource: A service qualified resource reference. StringType string `json:"stringType,omitempty"` - // StringValues: Optional. Suggested hints for string fields. These can be used - // to suggest values to users, through an UI for example. + // StringValues: Optional. Suggested hints for string fields. You can use them + // to suggest values to users through console. StringValues []string `json:"stringValues,omitempty"` // ForceSendFields is a list of field names (e.g. "Deprecated") to // unconditionally include in API requests. By default, fields with empty or @@ -969,9 +953,9 @@ func (s *GoogleCloudDataplexV1AspectTypeMetadataTemplateAnnotations) MarshalJSON } // GoogleCloudDataplexV1AspectTypeMetadataTemplateConstraints: Definition of -// the constraints of a field +// the constraints of a field. type GoogleCloudDataplexV1AspectTypeMetadataTemplateConstraints struct { - // Required: Optional. Marks this as an optional/required field. + // Required: Optional. Marks this field as optional or required. Required bool `json:"required,omitempty"` // ForceSendFields is a list of field names (e.g. "Required") to // unconditionally include in API requests. By default, fields with empty or @@ -992,15 +976,15 @@ func (s *GoogleCloudDataplexV1AspectTypeMetadataTemplateConstraints) MarshalJSON } // GoogleCloudDataplexV1AspectTypeMetadataTemplateEnumValue: Definition of -// Enumvalue (to be used by enum fields) +// Enumvalue, to be used for enum fields. type GoogleCloudDataplexV1AspectTypeMetadataTemplateEnumValue struct { - // Deprecated -- Optional. Optional deprecation message to be set if an enum - // value needs to be deprecated. + // Deprecated -- Optional. You can set this message if you need to deprecate an + // enum value. Deprecated string `json:"deprecated,omitempty"` - // Index: Required. Index for the enum. Cannot be modified. + // Index: Required. Index for the enum value. It can't be modified. Index int64 `json:"index,omitempty"` // Name: Required. Name of the enumvalue. This is the actual value that the - // aspect will contain. + // aspect can contain. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Deprecated") to // unconditionally include in API requests. By default, fields with empty or @@ -3559,6 +3543,8 @@ func (s *GoogleCloudDataplexV1DataScanExecutionStatus) MarshalJSON() ([]byte, er // GoogleCloudDataplexV1DataScanJob: A DataScanJob represents an instance of // DataScan execution. type GoogleCloudDataplexV1DataScanJob struct { + // CreateTime: Output only. The time when the DataScanJob was created. + CreateTime string `json:"createTime,omitempty"` // DataProfileResult: Output only. The result of the data profile scan. DataProfileResult *GoogleCloudDataplexV1DataProfileResult `json:"dataProfileResult,omitempty"` // DataProfileSpec: Output only. DataProfileScan related setting. @@ -3602,15 +3588,15 @@ type GoogleCloudDataplexV1DataScanJob struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "DataProfileResult") to + // ForceSendFields is a list of field names (e.g. "CreateTime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "DataProfileResult") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -4020,14 +4006,15 @@ func (s *GoogleCloudDataplexV1EntityCompatibilityStatusCompatibility) MarshalJSO // which can be described by various metadata. type GoogleCloudDataplexV1Entry struct { // Aspects: Optional. The Aspects attached to the Entry. The format for the key - // can be one of the following: 1. {projectId}.{locationId}.{aspectTypeId} (if - // the aspect is attached directly to the entry) 2. + // can be one of the following: {projectId}.{locationId}.{aspectTypeId} (if the + // aspect is attached directly to the entry) // {projectId}.{locationId}.{aspectTypeId}@{path} (if the aspect is attached to // an entry's path) Aspects map[string]GoogleCloudDataplexV1Aspect `json:"aspects,omitempty"` // CreateTime: Output only. The time when the Entry was created. CreateTime string `json:"createTime,omitempty"` - // EntrySource: Optional. Source system related information for an entry. + // EntrySource: Optional. Information related to the source system for an + // entry. EntrySource *GoogleCloudDataplexV1EntrySource `json:"entrySource,omitempty"` // EntryType: Required. Immutable. The resource name of the EntryType used to // create this Entry. @@ -4073,9 +4060,9 @@ type GoogleCloudDataplexV1EntryGroup struct { Description string `json:"description,omitempty"` // DisplayName: Optional. User friendly display name. DisplayName string `json:"displayName,omitempty"` - // Etag: This checksum is computed by the server based on the value of other - // fields, and may be sent on update and delete requests to ensure the client - // has an up-to-date value before proceeding. + // Etag: This checksum is computed by the service, and might be sent on update + // and delete requests to ensure the client has an up-to-date value before + // proceeding. Etag string `json:"etag,omitempty"` // Labels: Optional. User-defined labels for the EntryGroup. Labels map[string]string `json:"labels,omitempty"` @@ -4084,22 +4071,9 @@ type GoogleCloudDataplexV1EntryGroup struct { // projects/{project_number}/locations/{location_id}/entryGroups/{entry_group_id // }. Name string `json:"name,omitempty"` - // TransferStatus: Output only. Denotes the transfer status of the Entry Group. - // It is unspecified for Entry Group created from Dataplex API. - // - // Possible values: - // "TRANSFER_STATUS_UNSPECIFIED" - The default value. It is set for resources - // that were not subject for migration from Data Catalog service. - // "TRANSFER_STATUS_MIGRATED" - Indicates that a resource was migrated from - // Data Catalog service but it hasn't been transferred yet. In particular the - // resource cannot be updated from Dataplex API. - // "TRANSFER_STATUS_TRANSFERRED" - Indicates that a resource was transferred - // from Data Catalog service. The resource can only be updated from Dataplex - // API. - TransferStatus string `json:"transferStatus,omitempty"` - // Uid: Output only. System generated globally unique ID for the EntryGroup. - // This ID will be different if the EntryGroup is deleted and re-created with - // the same name. + // Uid: Output only. System generated globally unique ID for the EntryGroup. If + // you delete and recreate the EntryGroup with the same name, this ID will be + // different. Uid string `json:"uid,omitempty"` // UpdateTime: Output only. The time when the EntryGroup was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -4124,8 +4098,8 @@ func (s *GoogleCloudDataplexV1EntryGroup) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDataplexV1EntrySource: EntrySource contains source system related -// information for the entry. +// GoogleCloudDataplexV1EntrySource: EntrySource contains information related +// to the source system of the Entry. type GoogleCloudDataplexV1EntrySource struct { // Ancestors: Immutable. The ancestors of the Entry in the source system. Ancestors []*GoogleCloudDataplexV1EntrySourceAncestor `json:"ancestors,omitempty"` @@ -4140,10 +4114,10 @@ type GoogleCloudDataplexV1EntrySource struct { // Labels: User-defined labels. The maximum size of keys and values is 128 // characters each. Labels map[string]string `json:"labels,omitempty"` - // Location: Output only. Location of the resource in the source system. Entry - // will be searchable by this location. By default, this should match the + // Location: Output only. Location of the resource in the source system. You + // can search the Entry by this location. By default, this should match the // location of the EntryGroup containing this entry. A different value allows - // capturing source location for data external to GCP. + // capturing the source location for data external to Google Cloud. Location string `json:"location,omitempty"` // Platform: The platform containing the source system. The maximum size of the // field is 64 characters. @@ -4210,9 +4184,9 @@ type GoogleCloudDataplexV1EntryType struct { Description string `json:"description,omitempty"` // DisplayName: Optional. User friendly display name. DisplayName string `json:"displayName,omitempty"` - // Etag: Optional. This checksum is computed by the server based on the value - // of other fields, and may be sent on update and delete requests to ensure the - // client has an up-to-date value before proceeding. + // Etag: Optional. This checksum is computed by the service, and might be sent + // on update and delete requests to ensure the client has an up-to-date value + // before proceeding. Etag string `json:"etag,omitempty"` // Labels: Optional. User-defined labels for the EntryType. Labels map[string]string `json:"labels,omitempty"` @@ -4226,7 +4200,7 @@ type GoogleCloudDataplexV1EntryType struct { // System: Optional. The system that Entries of this type belongs to. Examples // include CloudSQL, MariaDB etc System string `json:"system,omitempty"` - // TypeAliases: Optional. Indicates the class this Entry Type belongs to, for + // TypeAliases: Optional. Indicates the classes this Entry Type belongs to, for // example, TABLE, DATABASE, MODEL. TypeAliases []string `json:"typeAliases,omitempty"` // Uid: Output only. System generated globally unique ID for the EntryType. @@ -4943,14 +4917,14 @@ func (s *GoogleCloudDataplexV1ListActionsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDataplexV1ListAspectTypesResponse: List AspectTypes response +// GoogleCloudDataplexV1ListAspectTypesResponse: List AspectTypes response. type GoogleCloudDataplexV1ListAspectTypesResponse struct { - // AspectTypes: ListAspectTypes under the given parent location. + // AspectTypes: AspectTypes under the given parent location. AspectTypes []*GoogleCloudDataplexV1AspectType `json:"aspectTypes,omitempty"` // NextPageToken: Token to retrieve the next page of results, or empty if there // are no more results in the list. NextPageToken string `json:"nextPageToken,omitempty"` - // UnreachableLocations: Locations that could not be reached. + // UnreachableLocations: Locations that the service couldn't reach. UnreachableLocations []string `json:"unreachableLocations,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -5209,10 +5183,12 @@ func (s *GoogleCloudDataplexV1ListEntitiesResponse) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDataplexV1ListEntriesResponse: List Entries response. type GoogleCloudDataplexV1ListEntriesResponse struct { - // Entries: The list of entries. + // Entries: The list of entries under the given parent location. Entries []*GoogleCloudDataplexV1Entry `json:"entries,omitempty"` - // NextPageToken: Pagination token. + // NextPageToken: Token to retrieve the next page of results, or empty if there + // are no more results in the list. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -5235,14 +5211,14 @@ func (s *GoogleCloudDataplexV1ListEntriesResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDataplexV1ListEntryGroupsResponse: List ListEntryGroups response. +// GoogleCloudDataplexV1ListEntryGroupsResponse: List entry groups response. type GoogleCloudDataplexV1ListEntryGroupsResponse struct { - // EntryGroups: ListEntryGroups under the given parent location. + // EntryGroups: Entry groups under the given parent location. EntryGroups []*GoogleCloudDataplexV1EntryGroup `json:"entryGroups,omitempty"` // NextPageToken: Token to retrieve the next page of results, or empty if there // are no more results in the list. NextPageToken string `json:"nextPageToken,omitempty"` - // UnreachableLocations: Locations that could not be reached. + // UnreachableLocations: Locations that the service couldn't reach. UnreachableLocations []string `json:"unreachableLocations,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -5265,14 +5241,14 @@ func (s *GoogleCloudDataplexV1ListEntryGroupsResponse) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDataplexV1ListEntryTypesResponse: List EntryTypes response +// GoogleCloudDataplexV1ListEntryTypesResponse: List EntryTypes response. type GoogleCloudDataplexV1ListEntryTypesResponse struct { - // EntryTypes: ListEntryTypes under the given parent location. + // EntryTypes: EntryTypes under the given parent location. EntryTypes []*GoogleCloudDataplexV1EntryType `json:"entryTypes,omitempty"` // NextPageToken: Token to retrieve the next page of results, or empty if there // are no more results in the list. NextPageToken string `json:"nextPageToken,omitempty"` - // UnreachableLocations: Locations that could not be reached. + // UnreachableLocations: Locations that the service couldn't reach. UnreachableLocations []string `json:"unreachableLocations,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -5901,15 +5877,16 @@ func (s *GoogleCloudDataplexV1SchemaSchemaField) MarshalJSON() ([]byte, error) { } type GoogleCloudDataplexV1SearchEntriesResponse struct { - // NextPageToken: Pagination token. + // NextPageToken: Token to retrieve the next page of results, or empty if there + // are no more results in the list. NextPageToken string `json:"nextPageToken,omitempty"` // Results: The results matching the search query. Results []*GoogleCloudDataplexV1SearchEntriesResult `json:"results,omitempty"` - // TotalSize: The estimated total number of matching entries. Not guaranteed to - // be accurate. + // TotalSize: The estimated total number of matching entries. This number isn't + // guaranteed to be accurate. TotalSize int64 `json:"totalSize,omitempty"` - // Unreachable: Unreachable locations. Search results don't include data from - // those locations. + // Unreachable: Locations that the service couldn't reach. Search results don't + // include data from these locations. Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -7773,7 +7750,8 @@ type ProjectsLocationsLookupEntryCall struct { header_ http.Header } -// LookupEntry: Looks up a single entry. +// LookupEntry: Looks up a single Entry by name using the permission on the +// source system. // // - name: The project to which the request should be attributed in the // following form: projects/{project}/locations/{location}. @@ -7784,8 +7762,7 @@ func (r *ProjectsLocationsService) LookupEntry(name string) *ProjectsLocationsLo } // AspectTypes sets the optional parameter "aspectTypes": Limits the aspects -// returned to the provided aspect types. Only works if the CUSTOM view is -// selected. +// returned to the provided aspect types. It only works for CUSTOM view. func (c *ProjectsLocationsLookupEntryCall) AspectTypes(aspectTypes ...string) *ProjectsLocationsLookupEntryCall { c.urlParams_.SetMulti("aspectTypes", append([]string{}, aspectTypes...)) return c @@ -7801,15 +7778,15 @@ func (c *ProjectsLocationsLookupEntryCall) Entry(entry string) *ProjectsLocation } // Paths sets the optional parameter "paths": Limits the aspects returned to -// those associated with the provided paths within the Entry. Only works if the -// CUSTOM view is selected. +// those associated with the provided paths within the Entry. It only works for +// CUSTOM view. func (c *ProjectsLocationsLookupEntryCall) Paths(paths ...string) *ProjectsLocationsLookupEntryCall { c.urlParams_.SetMulti("paths", append([]string{}, paths...)) return c } -// View sets the optional parameter "view": View for controlling which parts of -// an entry are to be returned. +// View sets the optional parameter "view": View to control which parts of an +// entry the service should return. // // Possible values: // @@ -7821,11 +7798,11 @@ func (c *ProjectsLocationsLookupEntryCall) Paths(paths ...string) *ProjectsLocat // // "CUSTOM" - Returns aspects matching custom fields in GetEntryRequest. If // -// the number of aspects would exceed 100, the first 100 will be returned. +// the number of aspects exceeds 100, the first 100 will be returned. // -// "ALL" - Returns all aspects. If the number of aspects would exceed 100, +// "ALL" - Returns all aspects. If the number of aspects exceeds 100, the // -// the first 100 will be returned. +// first 100 will be returned. func (c *ProjectsLocationsLookupEntryCall) View(view string) *ProjectsLocationsLookupEntryCall { c.urlParams_.Set("view", view) return c @@ -7929,7 +7906,7 @@ type ProjectsLocationsSearchEntriesCall struct { header_ http.Header } -// SearchEntries: Searches for entries matching given query and scope. +// SearchEntries: Searches for Entries matching the given query and scope. // // - name: The project to which the request should be attributed in the // following form: projects/{project}/locations/{location}. @@ -7939,20 +7916,23 @@ func (r *ProjectsLocationsService) SearchEntries(name string) *ProjectsLocations return c } -// OrderBy sets the optional parameter "orderBy": Ordering of the results. -// Supported options to be added later. +// OrderBy sets the optional parameter "orderBy": Specifies the ordering of +// results. func (c *ProjectsLocationsSearchEntriesCall) OrderBy(orderBy string) *ProjectsLocationsSearchEntriesCall { c.urlParams_.Set("orderBy", orderBy) return c } -// PageSize sets the optional parameter "pageSize": Pagination. +// PageSize sets the optional parameter "pageSize": Number of results in the +// search page. If <=0, then defaults to 10. Max limit for page_size is 1000. +// Throws an invalid argument for page_size > 1000. func (c *ProjectsLocationsSearchEntriesCall) PageSize(pageSize int64) *ProjectsLocationsSearchEntriesCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// PageToken sets the optional parameter "pageToken": +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous SearchEntries call. Provide this to retrieve the subsequent page. func (c *ProjectsLocationsSearchEntriesCall) PageToken(pageToken string) *ProjectsLocationsSearchEntriesCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -7966,9 +7946,9 @@ func (c *ProjectsLocationsSearchEntriesCall) Query(query string) *ProjectsLocati } // Scope sets the optional parameter "scope": The scope under which the search -// should be operating. Should either be organizations/ or projects/. If left -// unspecified, it will default to the organization where the project provided -// in name is located. +// should be operating. It must either be organizations/ or projects/. If it is +// unspecified, it defaults to the organization where the project provided in +// name is located. func (c *ProjectsLocationsSearchEntriesCall) Scope(scope string) *ProjectsLocationsSearchEntriesCall { c.urlParams_.Set("scope", scope) return c @@ -8083,11 +8063,11 @@ type ProjectsLocationsAspectTypesCreateCall struct { header_ http.Header } -// Create: Creates an AspectType +// Create: Creates an AspectType. // // - parent: The resource name of the AspectType, of the form: // projects/{project_number}/locations/{location_id} where location_id refers -// to a GCP region. +// to a Google Cloud region. func (r *ProjectsLocationsAspectTypesService) Create(parent string, googleclouddataplexv1aspecttype *GoogleCloudDataplexV1AspectType) *ProjectsLocationsAspectTypesCreateCall { c := &ProjectsLocationsAspectTypesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8102,8 +8082,9 @@ func (c *ProjectsLocationsAspectTypesCreateCall) AspectTypeId(aspectTypeId strin return c } -// ValidateOnly sets the optional parameter "validateOnly": Only validate the -// request, but do not perform mutations. The default is false. +// ValidateOnly sets the optional parameter "validateOnly": The service +// validates the request without performing any mutations. The default is +// false. func (c *ProjectsLocationsAspectTypesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsAspectTypesCreateCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -8200,7 +8181,7 @@ type ProjectsLocationsAspectTypesDeleteCall struct { header_ http.Header } -// Delete: Deletes a AspectType resource. +// Delete: Deletes an AspectType. // // - name: The resource name of the AspectType: // projects/{project_number}/locations/{location_id}/aspectTypes/{aspect_type_ @@ -8213,7 +8194,7 @@ func (r *ProjectsLocationsAspectTypesService) Delete(name string) *ProjectsLocat // Etag sets the optional parameter "etag": If the client provided etag value // does not match the current etag value, the DeleteAspectTypeRequest method -// returns an ABORTED error response +// returns an ABORTED error response. func (c *ProjectsLocationsAspectTypesDeleteCall) Etag(etag string) *ProjectsLocationsAspectTypesDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -8307,7 +8288,7 @@ type ProjectsLocationsAspectTypesGetCall struct { header_ http.Header } -// Get: Retrieves a AspectType resource. +// Get: Gets an AspectType. // // - name: The resource name of the AspectType: // projects/{project_number}/locations/{location_id}/aspectTypes/{aspect_type_ @@ -8549,7 +8530,7 @@ type ProjectsLocationsAspectTypesListCall struct { // // - parent: The resource name of the AspectType location, of the form: // projects/{project_number}/locations/{location_id} where location_id refers -// to a GCP region. +// to a Google Cloud region. func (r *ProjectsLocationsAspectTypesService) List(parent string) *ProjectsLocationsAspectTypesListCall { c := &ProjectsLocationsAspectTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8557,16 +8538,16 @@ func (r *ProjectsLocationsAspectTypesService) List(parent string) *ProjectsLocat } // Filter sets the optional parameter "filter": Filter request. Filters are -// case-sensitive. The following formats are supported:labels.key1 = "value1" -// labels:key1 name = "value" These restrictions can be coinjoined with AND, OR -// and NOT conjunctions. +// case-sensitive. The service supports the following formats: labels.key1 = +// "value1" labels:key1 name = "value"These restrictions can be conjoined with +// AND, OR, and NOT conjunctions. func (c *ProjectsLocationsAspectTypesListCall) Filter(filter string) *ProjectsLocationsAspectTypesListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Order by fields (name or -// create_time) for the result. If not specified, the ordering is undefined. +// OrderBy sets the optional parameter "orderBy": Orders the result by name or +// create_time fields. If not specified, the ordering is undefined. func (c *ProjectsLocationsAspectTypesListCall) OrderBy(orderBy string) *ProjectsLocationsAspectTypesListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -8574,8 +8555,8 @@ func (c *ProjectsLocationsAspectTypesListCall) OrderBy(orderBy string) *Projects // PageSize sets the optional parameter "pageSize": Maximum number of // AspectTypes to return. The service may return fewer than this value. If -// unspecified, at most 10 AspectTypes will be returned. The maximum value is -// 1000; values above 1000 will be coerced to 1000. +// unspecified, the service returns at most 10 AspectTypes. The maximum value +// is 1000; values above 1000 will be coerced to 1000. func (c *ProjectsLocationsAspectTypesListCall) PageSize(pageSize int64) *ProjectsLocationsAspectTypesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -8583,8 +8564,8 @@ func (c *ProjectsLocationsAspectTypesListCall) PageSize(pageSize int64) *Project // PageToken sets the optional parameter "pageToken": Page token received from // a previous ListAspectTypes call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to ListAspectTypes must -// match the call that provided the page token. +// page. When paginating, all other parameters you provide to ListAspectTypes +// must match the call that provided the page token. func (c *ProjectsLocationsAspectTypesListCall) PageToken(pageToken string) *ProjectsLocationsAspectTypesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -8710,7 +8691,7 @@ type ProjectsLocationsAspectTypesPatchCall struct { header_ http.Header } -// Patch: Updates a AspectType resource. +// Patch: Updates an AspectType. // // - name: Output only. The relative resource name of the AspectType, of the // form: @@ -13507,7 +13488,7 @@ type ProjectsLocationsEntryGroupsCreateCall struct { header_ http.Header } -// Create: Creates an EntryGroup +// Create: Creates an EntryGroup. // // - parent: The resource name of the entryGroup, of the form: // projects/{project_number}/locations/{location_id} where location_id refers @@ -13526,8 +13507,9 @@ func (c *ProjectsLocationsEntryGroupsCreateCall) EntryGroupId(entryGroupId strin return c } -// ValidateOnly sets the optional parameter "validateOnly": Only validate the -// request, but do not perform mutations. The default is false. +// ValidateOnly sets the optional parameter "validateOnly": The service +// validates the request without performing any mutations. The default is +// false. func (c *ProjectsLocationsEntryGroupsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsEntryGroupsCreateCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -13624,7 +13606,7 @@ type ProjectsLocationsEntryGroupsDeleteCall struct { header_ http.Header } -// Delete: Deletes a EntryGroup resource. +// Delete: Deletes an EntryGroup. // // - name: The resource name of the EntryGroup: // projects/{project_number}/locations/{location_id}/entryGroups/{entry_group_ @@ -13637,7 +13619,7 @@ func (r *ProjectsLocationsEntryGroupsService) Delete(name string) *ProjectsLocat // Etag sets the optional parameter "etag": If the client provided etag value // does not match the current etag value, the DeleteEntryGroupRequest method -// returns an ABORTED error response +// returns an ABORTED error response. func (c *ProjectsLocationsEntryGroupsDeleteCall) Etag(etag string) *ProjectsLocationsEntryGroupsDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -13731,7 +13713,7 @@ type ProjectsLocationsEntryGroupsGetCall struct { header_ http.Header } -// Get: Retrieves a EntryGroup resource. +// Get: Gets an EntryGroup. // // - name: The resource name of the EntryGroup: // projects/{project_number}/locations/{location_id}/entryGroups/{entry_group_ @@ -13973,7 +13955,7 @@ type ProjectsLocationsEntryGroupsListCall struct { // // - parent: The resource name of the entryGroup location, of the form: // projects/{project_number}/locations/{location_id} where location_id refers -// to a GCP region. +// to a Google Cloud region. func (r *ProjectsLocationsEntryGroupsService) List(parent string) *ProjectsLocationsEntryGroupsListCall { c := &ProjectsLocationsEntryGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13995,8 +13977,8 @@ func (c *ProjectsLocationsEntryGroupsListCall) OrderBy(orderBy string) *Projects // PageSize sets the optional parameter "pageSize": Maximum number of // EntryGroups to return. The service may return fewer than this value. If -// unspecified, at most 10 EntryGroups will be returned. The maximum value is -// 1000; values above 1000 will be coerced to 1000. +// unspecified, the service returns at most 10 EntryGroups. The maximum value +// is 1000; values above 1000 will be coerced to 1000. func (c *ProjectsLocationsEntryGroupsListCall) PageSize(pageSize int64) *ProjectsLocationsEntryGroupsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -14004,8 +13986,8 @@ func (c *ProjectsLocationsEntryGroupsListCall) PageSize(pageSize int64) *Project // PageToken sets the optional parameter "pageToken": Page token received from // a previous ListEntryGroups call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to ListEntryGroups must -// match the call that provided the page token. +// page. When paginating, all other parameters you provide to ListEntryGroups +// must match the call that provided the page token. func (c *ProjectsLocationsEntryGroupsListCall) PageToken(pageToken string) *ProjectsLocationsEntryGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -14131,7 +14113,7 @@ type ProjectsLocationsEntryGroupsPatchCall struct { header_ http.Header } -// Patch: Updates a EntryGroup resource. +// Patch: Updates an EntryGroup. // // - name: Output only. The relative resource name of the EntryGroup, of the // form: @@ -14151,8 +14133,9 @@ func (c *ProjectsLocationsEntryGroupsPatchCall) UpdateMask(updateMask string) *P return c } -// ValidateOnly sets the optional parameter "validateOnly": Only validate the -// request, but do not perform mutations. The default is false. +// ValidateOnly sets the optional parameter "validateOnly": The service +// validates the request, without performing any mutations. The default is +// false. func (c *ProjectsLocationsEntryGroupsPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsEntryGroupsPatchCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -14478,16 +14461,16 @@ func (r *ProjectsLocationsEntryGroupsEntriesService) Create(parent string, googl // EntryId sets the optional parameter "entryId": Required. Entry identifier. // It has to be unique within an Entry Group.Entries corresponding to Google -// Cloud resources use Entry ID format based on Full Resource Names +// Cloud resources use an Entry ID format based on full resource names // (https://cloud.google.com/apis/design/resource_names#full_resource_name). -// The format is a Full Resource Name of the resource without the prefix double -// slashes in the API Service Name part of Full Resource Name. This allows -// retrieval of entries using their associated resource name.For example if the -// Full Resource Name of a resource is +// The format is a full resource name of the resource without the prefix double +// slashes in the API service name part of the full resource name. This allows +// retrieval of entries using their associated resource name.For example, if +// the full resource name of a resource is // //library.googleapis.com/shelves/shelf1/books/book2, then the suggested // entry_id is library.googleapis.com/shelves/shelf1/books/book2.It is also // suggested to follow the same convention for entries corresponding to -// resources from other providers or systems than Google Cloud.The maximum size +// resources from providers or systems other than Google Cloud.The maximum size // of the field is 4000 characters. func (c *ProjectsLocationsEntryGroupsEntriesCreateCall) EntryId(entryId string) *ProjectsLocationsEntryGroupsEntriesCreateCall { c.urlParams_.Set("entryId", entryId) @@ -14684,7 +14667,7 @@ type ProjectsLocationsEntryGroupsEntriesGetCall struct { header_ http.Header } -// Get: Gets a single entry. +// Get: Gets an Entry. // // - name: The resource name of the Entry: // projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{ @@ -14696,23 +14679,22 @@ func (r *ProjectsLocationsEntryGroupsEntriesService) Get(name string) *ProjectsL } // AspectTypes sets the optional parameter "aspectTypes": Limits the aspects -// returned to the provided aspect types. Only works if the CUSTOM view is -// selected. +// returned to the provided aspect types. It only works for CUSTOM view. func (c *ProjectsLocationsEntryGroupsEntriesGetCall) AspectTypes(aspectTypes ...string) *ProjectsLocationsEntryGroupsEntriesGetCall { c.urlParams_.SetMulti("aspectTypes", append([]string{}, aspectTypes...)) return c } // Paths sets the optional parameter "paths": Limits the aspects returned to -// those associated with the provided paths within the Entry. Only works if the -// CUSTOM view is selected. +// those associated with the provided paths within the Entry. It only works for +// CUSTOM view. func (c *ProjectsLocationsEntryGroupsEntriesGetCall) Paths(paths ...string) *ProjectsLocationsEntryGroupsEntriesGetCall { c.urlParams_.SetMulti("paths", append([]string{}, paths...)) return c } -// View sets the optional parameter "view": View for controlling which parts of -// an entry are to be returned. +// View sets the optional parameter "view": View to control which parts of an +// entry the service should return. // // Possible values: // @@ -14724,11 +14706,11 @@ func (c *ProjectsLocationsEntryGroupsEntriesGetCall) Paths(paths ...string) *Pro // // "CUSTOM" - Returns aspects matching custom fields in GetEntryRequest. If // -// the number of aspects would exceed 100, the first 100 will be returned. +// the number of aspects exceeds 100, the first 100 will be returned. // -// "ALL" - Returns all aspects. If the number of aspects would exceed 100, +// "ALL" - Returns all aspects. If the number of aspects exceeds 100, the // -// the first 100 will be returned. +// first 100 will be returned. func (c *ProjectsLocationsEntryGroupsEntriesGetCall) View(view string) *ProjectsLocationsEntryGroupsEntriesGetCall { c.urlParams_.Set("view", view) return c @@ -14833,7 +14815,7 @@ type ProjectsLocationsEntryGroupsEntriesListCall struct { header_ http.Header } -// List: Lists entries within an entry group. +// List: Lists Entries within an EntryGroup. // // - parent: The resource name of the parent Entry Group: // projects/{project}/locations/{location}/entryGroups/{entry_group}. @@ -14844,12 +14826,12 @@ func (r *ProjectsLocationsEntryGroupsEntriesService) List(parent string) *Projec } // Filter sets the optional parameter "filter": A filter on the entries to -// return. Filters are case-sensitive. The request can be filtered by the -// following fields: entry_type, entry_source.display_name. The comparison -// operators are =, !=, <, >, <=, >= (strings are compared according to lexical -// order) The logical operators AND, OR, NOT can be used in the filter. -// Wildcard "*" can be used, but for entry_type the full project id or number -// needs to be provided. Example filter expressions: +// return. Filters are case-sensitive. You can filter the request by the +// following fields: entry_type entry_source.display_nameThe comparison +// operators are =, !=, <, >, <=, >=. The service compares strings according to +// lexical order.You can use the logical operators AND, OR, NOT in the +// filter.You can use Wildcard "*", but for entry_type you need to provide the +// full project id or number.Example filter expressions: // "entry_source.display_name=AnExampleDisplayName" // "entry_type=projects/example-project/locations/global/entryTypes/example-entr // y_type" "entry_type=projects/example-project/locations/us/entryTypes/a* OR @@ -14860,14 +14842,17 @@ func (c *ProjectsLocationsEntryGroupsEntriesListCall) Filter(filter string) *Pro return c } -// PageSize sets the optional parameter "pageSize": +// PageSize sets the optional parameter "pageSize": Number of items to return +// per page. If there are remaining results, the service returns a +// next_page_token. If unspecified, the service returns at most 10 Entries. The +// maximum value is 100; values above 100 will be coerced to 100. func (c *ProjectsLocationsEntryGroupsEntriesListCall) PageSize(pageSize int64) *ProjectsLocationsEntryGroupsEntriesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// PageToken sets the optional parameter "pageToken": The pagination token -// returned by a previous request. +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous ListEntries call. Provide this to retrieve the subsequent page. func (c *ProjectsLocationsEntryGroupsEntriesListCall) PageToken(pageToken string) *ProjectsLocationsEntryGroupsEntriesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -15006,28 +14991,29 @@ func (r *ProjectsLocationsEntryGroupsEntriesService) Patch(name string, googlecl } // AllowMissing sets the optional parameter "allowMissing": If set to true and -// the entry does not exist, it will be created. +// the entry doesn't exist, the service will create it. func (c *ProjectsLocationsEntryGroupsEntriesPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsEntryGroupsEntriesPatchCall { c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) return c } // AspectKeys sets the optional parameter "aspectKeys": The map keys of the -// Aspects which should be modified. Supports the following syntaxes: * - -// matches aspect on given type and empty path * @path - matches aspect on -// given type and specified path * * - matches aspects on given type for all -// paths * *@path - matches aspects of all types on the given pathExisting -// aspects matching the syntax will not be removed unless -// delete_missing_aspects is set to true.If this field is left empty, it will -// be treated as specifying exactly those Aspects present in the request. +// Aspects which the service should modify. It supports the following syntaxes: +// - matches an aspect of the given type and empty path. @path - matches an +// aspect of the given type and specified path. * - matches aspects of the +// given type for all paths. *@path - matches aspects of all types on the given +// path.The service will not remove existing aspects matching the syntax unless +// delete_missing_aspects is set to true.If this field is left empty, the +// service treats it as specifying exactly those Aspects present in the +// request. func (c *ProjectsLocationsEntryGroupsEntriesPatchCall) AspectKeys(aspectKeys ...string) *ProjectsLocationsEntryGroupsEntriesPatchCall { c.urlParams_.SetMulti("aspectKeys", append([]string{}, aspectKeys...)) return c } // DeleteMissingAspects sets the optional parameter "deleteMissingAspects": If -// set to true and the aspect_keys specify aspect ranges, any existing aspects -// from that range not provided in the request will be deleted. +// set to true and the aspect_keys specify aspect ranges, the service deletes +// any existing aspects from that range that weren't provided in the request. func (c *ProjectsLocationsEntryGroupsEntriesPatchCall) DeleteMissingAspects(deleteMissingAspects bool) *ProjectsLocationsEntryGroupsEntriesPatchCall { c.urlParams_.Set("deleteMissingAspects", fmt.Sprint(deleteMissingAspects)) return c @@ -15035,8 +15021,8 @@ func (c *ProjectsLocationsEntryGroupsEntriesPatchCall) DeleteMissingAspects(dele // UpdateMask sets the optional parameter "updateMask": Mask of fields to // update. To update Aspects, the update_mask must contain the value -// "aspects".If the update_mask is empty, all modifiable fields present in the -// request will be updated. +// "aspects".If the update_mask is empty, the service will update all +// modifiable fields present in the request. func (c *ProjectsLocationsEntryGroupsEntriesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsEntryGroupsEntriesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -15134,11 +15120,11 @@ type ProjectsLocationsEntryTypesCreateCall struct { header_ http.Header } -// Create: Creates an EntryType +// Create: Creates an EntryType. // // - parent: The resource name of the EntryType, of the form: // projects/{project_number}/locations/{location_id} where location_id refers -// to a GCP region. +// to a Google Cloud region. func (r *ProjectsLocationsEntryTypesService) Create(parent string, googleclouddataplexv1entrytype *GoogleCloudDataplexV1EntryType) *ProjectsLocationsEntryTypesCreateCall { c := &ProjectsLocationsEntryTypesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -15153,8 +15139,9 @@ func (c *ProjectsLocationsEntryTypesCreateCall) EntryTypeId(entryTypeId string) return c } -// ValidateOnly sets the optional parameter "validateOnly": Only validate the -// request, but do not perform mutations. The default is false. +// ValidateOnly sets the optional parameter "validateOnly": The service +// validates the request without performing any mutations. The default is +// false. func (c *ProjectsLocationsEntryTypesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsEntryTypesCreateCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c @@ -15251,7 +15238,7 @@ type ProjectsLocationsEntryTypesDeleteCall struct { header_ http.Header } -// Delete: Deletes a EntryType resource. +// Delete: Deletes an EntryType. // // - name: The resource name of the EntryType: // projects/{project_number}/locations/{location_id}/entryTypes/{entry_type_id @@ -15264,7 +15251,7 @@ func (r *ProjectsLocationsEntryTypesService) Delete(name string) *ProjectsLocati // Etag sets the optional parameter "etag": If the client provided etag value // does not match the current etag value, the DeleteEntryTypeRequest method -// returns an ABORTED error response +// returns an ABORTED error response. func (c *ProjectsLocationsEntryTypesDeleteCall) Etag(etag string) *ProjectsLocationsEntryTypesDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -15358,7 +15345,7 @@ type ProjectsLocationsEntryTypesGetCall struct { header_ http.Header } -// Get: Retrieves a EntryType resource. +// Get: Gets an EntryType. // // - name: The resource name of the EntryType: // projects/{project_number}/locations/{location_id}/entryTypes/{entry_type_id @@ -15600,7 +15587,7 @@ type ProjectsLocationsEntryTypesListCall struct { // // - parent: The resource name of the EntryType location, of the form: // projects/{project_number}/locations/{location_id} where location_id refers -// to a GCP region. +// to a Google Cloud region. func (r *ProjectsLocationsEntryTypesService) List(parent string) *ProjectsLocationsEntryTypesListCall { c := &ProjectsLocationsEntryTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -15608,16 +15595,16 @@ func (r *ProjectsLocationsEntryTypesService) List(parent string) *ProjectsLocati } // Filter sets the optional parameter "filter": Filter request. Filters are -// case-sensitive. The following formats are supported:labels.key1 = "value1" -// labels:key1 name = "value" These restrictions can be coinjoined with AND, OR -// and NOT conjunctions. +// case-sensitive. The service supports the following formats: labels.key1 = +// "value1" labels:key1 name = "value"These restrictions can be conjoined with +// AND, OR, and NOT conjunctions. func (c *ProjectsLocationsEntryTypesListCall) Filter(filter string) *ProjectsLocationsEntryTypesListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Order by fields (name or -// create_time) for the result. If not specified, the ordering is undefined. +// OrderBy sets the optional parameter "orderBy": Orders the result by name or +// create_time fields. If not specified, the ordering is undefined. func (c *ProjectsLocationsEntryTypesListCall) OrderBy(orderBy string) *ProjectsLocationsEntryTypesListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -15625,7 +15612,7 @@ func (c *ProjectsLocationsEntryTypesListCall) OrderBy(orderBy string) *ProjectsL // PageSize sets the optional parameter "pageSize": Maximum number of // EntryTypes to return. The service may return fewer than this value. If -// unspecified, at most 10 EntryTypes will be returned. The maximum value is +// unspecified, the service returns at most 10 EntryTypes. The maximum value is // 1000; values above 1000 will be coerced to 1000. func (c *ProjectsLocationsEntryTypesListCall) PageSize(pageSize int64) *ProjectsLocationsEntryTypesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) @@ -15634,8 +15621,8 @@ func (c *ProjectsLocationsEntryTypesListCall) PageSize(pageSize int64) *Projects // PageToken sets the optional parameter "pageToken": Page token received from // a previous ListEntryTypes call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to ListEntryTypes must -// match the call that provided the page token. +// page. When paginating, all other parameters you provided to ListEntryTypes +// must match the call that provided the page token. func (c *ProjectsLocationsEntryTypesListCall) PageToken(pageToken string) *ProjectsLocationsEntryTypesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -15761,7 +15748,7 @@ type ProjectsLocationsEntryTypesPatchCall struct { header_ http.Header } -// Patch: Updates a EntryType resource. +// Patch: Updates an EntryType. // // - name: Output only. The relative resource name of the EntryType, of the // form: @@ -15781,8 +15768,9 @@ func (c *ProjectsLocationsEntryTypesPatchCall) UpdateMask(updateMask string) *Pr return c } -// ValidateOnly sets the optional parameter "validateOnly": Only validate the -// request, but do not perform mutations. The default is false. +// ValidateOnly sets the optional parameter "validateOnly": The service +// validates the request without performing any mutations. The default is +// false. func (c *ProjectsLocationsEntryTypesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsEntryTypesPatchCall { c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) return c diff --git a/networkservices/v1/networkservices-api.json b/networkservices/v1/networkservices-api.json index f15b765552..774cda4853 100644 --- a/networkservices/v1/networkservices-api.json +++ b/networkservices/v1/networkservices-api.json @@ -2725,7 +2725,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", + "description": "Identifier. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/tlsRoutes/[^/]+$", "required": true, @@ -2756,7 +2756,7 @@ } } }, - "revision": "20240613", + "revision": "20240626", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -5021,7 +5021,7 @@ "type": "array" }, "name": { - "description": "Required. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", + "description": "Identifier. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", "type": "string" }, "rules": { diff --git a/networkservices/v1/networkservices-gen.go b/networkservices/v1/networkservices-gen.go index 477ff532d8..7eb7856cfc 100644 --- a/networkservices/v1/networkservices-gen.go +++ b/networkservices/v1/networkservices-gen.go @@ -3487,7 +3487,7 @@ type TlsRoute struct { // `projects/*/locations/global/meshes/` The attached Mesh should be of a type // SIDECAR Meshes []string `json:"meshes,omitempty"` - // Name: Required. Name of the TlsRoute resource. It matches pattern + // Name: Identifier. Name of the TlsRoute resource. It matches pattern // `projects/*/locations/global/tlsRoutes/tls_route_name>`. Name string `json:"name,omitempty"` // Rules: Required. Rules that define how traffic is routed and handled. At @@ -13331,7 +13331,7 @@ type ProjectsLocationsTlsRoutesPatchCall struct { // Patch: Updates the parameters of a single TlsRoute. // -// - name: Name of the TlsRoute resource. It matches pattern +// - name: Identifier. Name of the TlsRoute resource. It matches pattern // `projects/*/locations/global/tlsRoutes/tls_route_name>`. func (r *ProjectsLocationsTlsRoutesService) Patch(name string, tlsroute *TlsRoute) *ProjectsLocationsTlsRoutesPatchCall { c := &ProjectsLocationsTlsRoutesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} diff --git a/networkservices/v1beta1/networkservices-api.json b/networkservices/v1beta1/networkservices-api.json index 59baab9aac..06cb3dbd6c 100644 --- a/networkservices/v1beta1/networkservices-api.json +++ b/networkservices/v1beta1/networkservices-api.json @@ -2452,7 +2452,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", + "description": "Identifier. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/tlsRoutes/[^/]+$", "required": true, @@ -2483,7 +2483,7 @@ } } }, - "revision": "20240613", + "revision": "20240626", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -4748,7 +4748,7 @@ "type": "array" }, "name": { - "description": "Required. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", + "description": "Identifier. Name of the TlsRoute resource. It matches pattern `projects/*/locations/global/tlsRoutes/tls_route_name\u003e`.", "type": "string" }, "rules": { diff --git a/networkservices/v1beta1/networkservices-gen.go b/networkservices/v1beta1/networkservices-gen.go index 5b4aadddf5..66a59a9b0a 100644 --- a/networkservices/v1beta1/networkservices-gen.go +++ b/networkservices/v1beta1/networkservices-gen.go @@ -3450,7 +3450,7 @@ type TlsRoute struct { // `projects/*/locations/global/meshes/` The attached Mesh should be of a type // SIDECAR Meshes []string `json:"meshes,omitempty"` - // Name: Required. Name of the TlsRoute resource. It matches pattern + // Name: Identifier. Name of the TlsRoute resource. It matches pattern // `projects/*/locations/global/tlsRoutes/tls_route_name>`. Name string `json:"name,omitempty"` // Rules: Required. Rules that define how traffic is routed and handled. At @@ -12271,7 +12271,7 @@ type ProjectsLocationsTlsRoutesPatchCall struct { // Patch: Updates the parameters of a single TlsRoute. // -// - name: Name of the TlsRoute resource. It matches pattern +// - name: Identifier. Name of the TlsRoute resource. It matches pattern // `projects/*/locations/global/tlsRoutes/tls_route_name>`. func (r *ProjectsLocationsTlsRoutesService) Patch(name string, tlsroute *TlsRoute) *ProjectsLocationsTlsRoutesPatchCall { c := &ProjectsLocationsTlsRoutesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} diff --git a/vmwareengine/v1/vmwareengine-api.json b/vmwareengine/v1/vmwareengine-api.json index e70443eed5..876e533bf7 100644 --- a/vmwareengine/v1/vmwareengine-api.json +++ b/vmwareengine/v1/vmwareengine-api.json @@ -3173,7 +3173,7 @@ } } }, - "revision": "20240528", + "revision": "20240701", "rootUrl": "https://vmwareengine.googleapis.com/", "schemas": { "AuditConfig": { @@ -3224,6 +3224,67 @@ }, "type": "object" }, + "AutoscalingPolicy": { + "description": "Autoscaling policy describes the behavior of the autoscaling with respect to the resource utilization. The scale-out operation is initiated if the utilization exceeds ANY of the respective thresholds. The scale-in operation is initiated if the utilization is below ALL of the respective thresholds.", + "id": "AutoscalingPolicy", + "properties": { + "consumedMemoryThresholds": { + "$ref": "Thresholds", + "description": "Optional. Utilization thresholds pertaining to amount of consumed memory." + }, + "cpuThresholds": { + "$ref": "Thresholds", + "description": "Optional. Utilization thresholds pertaining to CPU utilization." + }, + "grantedMemoryThresholds": { + "$ref": "Thresholds", + "description": "Optional. Utilization thresholds pertaining to amount of granted memory." + }, + "nodeTypeId": { + "description": "Required. The canonical identifier of the node type to add or remove. Corresponds to the `NodeType`.", + "type": "string" + }, + "scaleOutSize": { + "description": "Required. Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters. During a scale-in operation only one node (or 2 for stretched clusters) are removed in a single iteration.", + "format": "int32", + "type": "integer" + }, + "storageThresholds": { + "$ref": "Thresholds", + "description": "Optional. Utilization thresholds pertaining to amount of consumed storage." + } + }, + "type": "object" + }, + "AutoscalingSettings": { + "description": "Autoscaling settings define the rules used by VMware Engine to automatically scale-out and scale-in the clusters in a private cloud.", + "id": "AutoscalingSettings", + "properties": { + "autoscalingPolicies": { + "additionalProperties": { + "$ref": "AutoscalingPolicy" + }, + "description": "Required. The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements: * Only contains 1-63 alphanumeric characters and hyphens * Begins with an alphabetical character * Ends with a non-hyphen character * Not formatted as a UUID * Complies with [RFC 1034](https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5) Currently there map must contain only one element that describes the autoscaling policy for compute nodes.", + "type": "object" + }, + "coolDownPeriod": { + "description": "Optional. The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Defaults to 30 minutes if not specified. Cool down period must be in whole minutes (for example, 30, 31, 50, 180 minutes).", + "format": "google-duration", + "type": "string" + }, + "maxClusterNodeCount": { + "description": "Optional. Maximum number of nodes of any type in a cluster. If not specified the default limits apply.", + "format": "int32", + "type": "integer" + }, + "minClusterNodeCount": { + "description": "Optional. Minimum number of nodes of any type in a cluster. If not specified the default limits apply.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "Binding": { "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", @@ -3250,6 +3311,10 @@ "description": "A cluster in a private cloud.", "id": "Cluster", "properties": { + "autoscalingSettings": { + "$ref": "AutoscalingSettings", + "description": "Optional. Configuration of the autoscaling applied to this cluster." + }, "createTime": { "description": "Output only. Creation time of this resource.", "format": "google-datetime", @@ -5382,6 +5447,23 @@ }, "type": "object" }, + "Thresholds": { + "description": "Thresholds define the utilization of resources triggering scale-out and scale-in operations.", + "id": "Thresholds", + "properties": { + "scaleIn": { + "description": "Required. The utilization triggering the scale-in operation in percent.", + "format": "int32", + "type": "integer" + }, + "scaleOut": { + "description": "Required. The utilization triggering the scale-out operation in percent.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "UndeletePrivateCloudRequest": { "description": "Request message for VmwareEngine.UndeletePrivateCloud", "id": "UndeletePrivateCloudRequest", diff --git a/vmwareengine/v1/vmwareengine-gen.go b/vmwareengine/v1/vmwareengine-gen.go index b64ac35b21..5550f3b1d5 100644 --- a/vmwareengine/v1/vmwareengine-gen.go +++ b/vmwareengine/v1/vmwareengine-gen.go @@ -467,6 +467,92 @@ func (s *AuditLogConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// AutoscalingPolicy: Autoscaling policy describes the behavior of the +// autoscaling with respect to the resource utilization. The scale-out +// operation is initiated if the utilization exceeds ANY of the respective +// thresholds. The scale-in operation is initiated if the utilization is below +// ALL of the respective thresholds. +type AutoscalingPolicy struct { + // ConsumedMemoryThresholds: Optional. Utilization thresholds pertaining to + // amount of consumed memory. + ConsumedMemoryThresholds *Thresholds `json:"consumedMemoryThresholds,omitempty"` + // CpuThresholds: Optional. Utilization thresholds pertaining to CPU + // utilization. + CpuThresholds *Thresholds `json:"cpuThresholds,omitempty"` + // GrantedMemoryThresholds: Optional. Utilization thresholds pertaining to + // amount of granted memory. + GrantedMemoryThresholds *Thresholds `json:"grantedMemoryThresholds,omitempty"` + // NodeTypeId: Required. The canonical identifier of the node type to add or + // remove. Corresponds to the `NodeType`. + NodeTypeId string `json:"nodeTypeId,omitempty"` + // ScaleOutSize: Required. Number of nodes to add to a cluster during a + // scale-out operation. Must be divisible by 2 for stretched clusters. During a + // scale-in operation only one node (or 2 for stretched clusters) are removed + // in a single iteration. + ScaleOutSize int64 `json:"scaleOutSize,omitempty"` + // StorageThresholds: Optional. Utilization thresholds pertaining to amount of + // consumed storage. + StorageThresholds *Thresholds `json:"storageThresholds,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConsumedMemoryThresholds") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConsumedMemoryThresholds") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *AutoscalingPolicy) MarshalJSON() ([]byte, error) { + type NoMethod AutoscalingPolicy + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +// AutoscalingSettings: Autoscaling settings define the rules used by VMware +// Engine to automatically scale-out and scale-in the clusters in a private +// cloud. +type AutoscalingSettings struct { + // AutoscalingPolicies: Required. The map with autoscaling policies applied to + // the cluster. The key is the identifier of the policy. It must meet the + // following requirements: * Only contains 1-63 alphanumeric characters and + // hyphens * Begins with an alphabetical character * Ends with a non-hyphen + // character * Not formatted as a UUID * Complies with RFC 1034 + // (https://datatracker.ietf.org/doc/html/rfc1034) (section 3.5) Currently + // there map must contain only one element that describes the autoscaling + // policy for compute nodes. + AutoscalingPolicies map[string]AutoscalingPolicy `json:"autoscalingPolicies,omitempty"` + // CoolDownPeriod: Optional. The minimum duration between consecutive autoscale + // operations. It starts once addition or removal of nodes is fully completed. + // Defaults to 30 minutes if not specified. Cool down period must be in whole + // minutes (for example, 30, 31, 50, 180 minutes). + CoolDownPeriod string `json:"coolDownPeriod,omitempty"` + // MaxClusterNodeCount: Optional. Maximum number of nodes of any type in a + // cluster. If not specified the default limits apply. + MaxClusterNodeCount int64 `json:"maxClusterNodeCount,omitempty"` + // MinClusterNodeCount: Optional. Minimum number of nodes of any type in a + // cluster. If not specified the default limits apply. + MinClusterNodeCount int64 `json:"minClusterNodeCount,omitempty"` + // ForceSendFields is a list of field names (e.g. "AutoscalingPolicies") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AutoscalingPolicies") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *AutoscalingSettings) MarshalJSON() ([]byte, error) { + type NoMethod AutoscalingSettings + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Binding: Associates `members`, or principals, with a `role`. type Binding struct { // Condition: The condition that is associated with this binding. If the @@ -568,6 +654,9 @@ func (s *Binding) MarshalJSON() ([]byte, error) { // Cluster: A cluster in a private cloud. type Cluster struct { + // AutoscalingSettings: Optional. Configuration of the autoscaling applied to + // this cluster. + AutoscalingSettings *AutoscalingSettings `json:"autoscalingSettings,omitempty"` // CreateTime: Output only. Creation time of this resource. CreateTime string `json:"createTime,omitempty"` // Management: Output only. True if the cluster is a management cluster; false @@ -606,15 +695,15 @@ type Cluster struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to + // ForceSendFields is a list of field names (e.g. "AutoscalingSettings") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreateTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "AutoscalingSettings") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -3154,6 +3243,33 @@ func (s *TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// Thresholds: Thresholds define the utilization of resources triggering +// scale-out and scale-in operations. +type Thresholds struct { + // ScaleIn: Required. The utilization triggering the scale-in operation in + // percent. + ScaleIn int64 `json:"scaleIn,omitempty"` + // ScaleOut: Required. The utilization triggering the scale-out operation in + // percent. + ScaleOut int64 `json:"scaleOut,omitempty"` + // ForceSendFields is a list of field names (e.g. "ScaleIn") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ScaleIn") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *Thresholds) MarshalJSON() ([]byte, error) { + type NoMethod Thresholds + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // UndeletePrivateCloudRequest: Request message for // VmwareEngine.UndeletePrivateCloud type UndeletePrivateCloudRequest struct {