From 161e093a56763c64c9e0b16ee1940dc6969d1ead Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Sat, 9 Sep 2023 00:22:13 -0700 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2149) --- artifactregistry/v1/artifactregistry-api.json | 35 +- artifactregistry/v1/artifactregistry-gen.go | 50 +-- .../v1beta2/artifactregistry-api.json | 4 +- .../v1beta2/artifactregistry-gen.go | 2 +- composer/v1/composer-api.json | 12 +- composer/v1/composer-gen.go | 7 + datastore/v1/datastore-api.json | 4 +- datastore/v1/datastore-gen.go | 5 +- datastore/v1beta3/datastore-api.json | 4 +- datastore/v1beta3/datastore-gen.go | 5 +- domains/v1/domains-api.json | 6 +- domains/v1/domains-gen.go | 16 +- domains/v1alpha2/domains-api.json | 6 +- domains/v1alpha2/domains-gen.go | 16 +- domains/v1beta1/domains-api.json | 6 +- domains/v1beta1/domains-gen.go | 16 +- firestore/v1/firestore-api.json | 25 +- firestore/v1/firestore-gen.go | 58 +-- firestore/v1beta1/firestore-api.json | 19 +- firestore/v1beta1/firestore-gen.go | 44 +- firestore/v1beta2/firestore-api.json | 14 +- firestore/v1beta2/firestore-gen.go | 10 + gkehub/v1/gkehub-api.json | 8 +- gkehub/v1/gkehub-gen.go | 9 +- gkehub/v1alpha/gkehub-api.json | 11 +- gkehub/v1alpha/gkehub-gen.go | 12 +- gkehub/v1beta/gkehub-api.json | 9 +- gkehub/v1beta/gkehub-gen.go | 7 +- .../v1/networkconnectivity-api.json | 102 ++++- .../v1/networkconnectivity-gen.go | 396 +++++++++++++++++- .../v1beta1/networksecurity-api.json | 14 +- .../v1beta1/networksecurity-gen.go | 12 +- tpu/v2alpha1/tpu-api.json | 8 +- tpu/v2alpha1/tpu-gen.go | 10 + workloadmanager/v1/workloadmanager-api.json | 81 ++-- workloadmanager/v1/workloadmanager-gen.go | 101 +++-- 36 files changed, 818 insertions(+), 326 deletions(-) diff --git a/artifactregistry/v1/artifactregistry-api.json b/artifactregistry/v1/artifactregistry-api.json index 2b993e25db9..36e3c166b6e 100644 --- a/artifactregistry/v1/artifactregistry-api.json +++ b/artifactregistry/v1/artifactregistry-api.json @@ -1661,7 +1661,7 @@ } } }, - "revision": "20230809", + "revision": "20230905", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { @@ -3069,10 +3069,6 @@ "readOnly": true, "type": "boolean" }, - "sbomConfig": { - "$ref": "SbomConfig", - "description": "Optional. Config and state for sbom generation for resources within this Repository." - }, "sizeBytes": { "description": "Output only. The size, in bytes, of all artifact storage in this repository. Repositories that are generally available or in public preview use this to calculate storage costs.", "format": "int64", @@ -3092,33 +3088,6 @@ }, "type": "object" }, - "SbomConfig": { - "description": "Config for whether to generate SBOMs for resources in this repository, as well as output fields describing current state.", - "id": "SbomConfig", - "properties": { - "enablementConfig": { - "description": "Optional. Config for whether this repository has sbom generation disabled.", - "enum": [ - "ENABLEMENT_CONFIG_UNSPECIFIED", - "INHERITED", - "DISABLED" - ], - "enumDescriptions": [ - "Unspecified config was not set. This will be interpreted as DISABLED.", - "Inherited indicates the repository is allowed for SBOM generation, however the actual state will be inherited from the API enablement state.", - "Disabled indicates the repository will not generate SBOMs." - ], - "type": "string" - }, - "lastEnableTime": { - "description": "Output only. The last time this repository config was set to INHERITED.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", @@ -3360,7 +3329,7 @@ "id": "UploadYumArtifactResponse", "properties": { "yumArtifacts": { - "description": "The Apt artifacts updated.", + "description": "The Yum artifacts updated.", "items": { "$ref": "YumArtifact" }, diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index 16374b51fca..ad2a0b346b5 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -2732,10 +2732,6 @@ type Repository struct { // zone separation. SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` - // SbomConfig: Optional. Config and state for sbom generation for - // resources within this Repository. - SbomConfig *SbomConfig `json:"sbomConfig,omitempty"` - // SizeBytes: Output only. The size, in bytes, of all artifact storage // in this repository. Repositories that are generally available or in // public preview use this to calculate storage costs. @@ -2777,50 +2773,6 @@ func (s *Repository) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SbomConfig: Config for whether to generate SBOMs for resources in -// this repository, as well as output fields describing current state. -type SbomConfig struct { - // EnablementConfig: Optional. Config for whether this repository has - // sbom generation disabled. - // - // Possible values: - // "ENABLEMENT_CONFIG_UNSPECIFIED" - Unspecified config was not set. - // This will be interpreted as DISABLED. - // "INHERITED" - Inherited indicates the repository is allowed for - // SBOM generation, however the actual state will be inherited from the - // API enablement state. - // "DISABLED" - Disabled indicates the repository will not generate - // SBOMs. - EnablementConfig string `json:"enablementConfig,omitempty"` - - // LastEnableTime: Output only. The last time this repository config was - // set to INHERITED. - LastEnableTime string `json:"lastEnableTime,omitempty"` - - // ForceSendFields is a list of field names (e.g. "EnablementConfig") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "EnablementConfig") to - // include in API requests with the JSON null value. By default, fields - // with empty values are omitted from API requests. However, any field - // with an empty value appearing in NullFields will be sent to the - // server as null. It is an error if a field in this list has a - // non-empty value. This may be used to include null fields in Patch - // requests. - NullFields []string `json:"-"` -} - -func (s *SbomConfig) MarshalJSON() ([]byte, error) { - type NoMethod SbomConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the @@ -3303,7 +3255,7 @@ type UploadYumArtifactRequest struct { // upload operation. This response is contained in the Operation and // available to users. type UploadYumArtifactResponse struct { - // YumArtifacts: The Apt artifacts updated. + // YumArtifacts: The Yum artifacts updated. YumArtifacts []*YumArtifact `json:"yumArtifacts,omitempty"` // ForceSendFields is a list of field names (e.g. "YumArtifacts") to diff --git a/artifactregistry/v1beta2/artifactregistry-api.json b/artifactregistry/v1beta2/artifactregistry-api.json index a97a59f46c4..fa50a3d4618 100644 --- a/artifactregistry/v1beta2/artifactregistry-api.json +++ b/artifactregistry/v1beta2/artifactregistry-api.json @@ -1135,7 +1135,7 @@ } } }, - "revision": "20230803", + "revision": "20230905", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { @@ -1957,7 +1957,7 @@ "id": "UploadYumArtifactResponse", "properties": { "yumArtifacts": { - "description": "The Apt artifacts updated.", + "description": "The Yum artifacts updated.", "items": { "$ref": "YumArtifact" }, diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index 460a95c5916..f93dc398ec0 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -1792,7 +1792,7 @@ type UploadYumArtifactRequest struct { // upload operation. This response is contained in the Operation and // available to users. type UploadYumArtifactResponse struct { - // YumArtifacts: The Apt artifacts updated. + // YumArtifacts: The Yum artifacts updated. YumArtifacts []*YumArtifact `json:"yumArtifacts,omitempty"` // ForceSendFields is a list of field names (e.g. "YumArtifacts") to diff --git a/composer/v1/composer-api.json b/composer/v1/composer-api.json index 85bb182f898..980537115a5 100644 --- a/composer/v1/composer-api.json +++ b/composer/v1/composer-api.json @@ -599,7 +599,7 @@ } } }, - "revision": "20230806", + "revision": "20230906", "rootUrl": "https://composer.googleapis.com/", "schemas": { "AllowedIpRange": { @@ -781,6 +781,10 @@ ], "type": "string" }, + "storageConfig": { + "$ref": "StorageConfig", + "description": "Optional. Storage configuration for this environment." + }, "updateTime": { "description": "Output only. The time at which this environment was last modified.", "format": "google-datetime", @@ -1663,6 +1667,12 @@ }, "type": "object" }, + "StorageConfig": { + "description": "The configuration for data storage in the environment.", + "id": "StorageConfig", + "properties": {}, + "type": "object" + }, "WebServerConfig": { "description": "The configuration settings for the Airflow web server App Engine instance. Supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*", "id": "WebServerConfig", diff --git a/composer/v1/composer-gen.go b/composer/v1/composer-gen.go index a218755c216..331d4382a3c 100644 --- a/composer/v1/composer-gen.go +++ b/composer/v1/composer-gen.go @@ -500,6 +500,9 @@ type Environment struct { // used. State string `json:"state,omitempty"` + // StorageConfig: Optional. Storage configuration for this environment. + StorageConfig *StorageConfig `json:"storageConfig,omitempty"` + // UpdateTime: Output only. The time at which this environment was last // modified. UpdateTime string `json:"updateTime,omitempty"` @@ -2134,6 +2137,10 @@ func (s *StopAirflowCommandResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// StorageConfig: The configuration for data storage in the environment. +type StorageConfig struct { +} + // WebServerConfig: The configuration settings for the Airflow web // server App Engine instance. Supported for Cloud Composer environments // in versions composer-1.*.*-airflow-*.*.* diff --git a/datastore/v1/datastore-api.json b/datastore/v1/datastore-api.json index bbd91bdad5e..f19a92f6af3 100644 --- a/datastore/v1/datastore-api.json +++ b/datastore/v1/datastore-api.json @@ -654,7 +654,7 @@ } } }, - "revision": "20230806", + "revision": "20230905", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -2054,7 +2054,7 @@ "id": "PropertyReference", "properties": { "name": { - "description": "The name of the property. If name includes \".\"s, it may be interpreted as a property name path.", + "description": "A reference to a property. Requires: * MUST be a dot-delimited (`.`) string of segments, where each segment conforms to entity property name limitations.", "type": "string" } }, diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index 2fc73a49084..5ab745ac742 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -2628,8 +2628,9 @@ func (s *PropertyOrder) MarshalJSON() ([]byte, error) { // PropertyReference: A reference to a property relative to the kind // expressions. type PropertyReference struct { - // Name: The name of the property. If name includes "."s, it may be - // interpreted as a property name path. + // Name: A reference to a property. Requires: * MUST be a dot-delimited + // (`.`) string of segments, where each segment conforms to entity + // property name limitations. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to diff --git a/datastore/v1beta3/datastore-api.json b/datastore/v1beta3/datastore-api.json index 93d97b24bdc..94e793c5d34 100644 --- a/datastore/v1beta3/datastore-api.json +++ b/datastore/v1beta3/datastore-api.json @@ -336,7 +336,7 @@ } } }, - "revision": "20230806", + "revision": "20230905", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -1500,7 +1500,7 @@ "id": "PropertyReference", "properties": { "name": { - "description": "The name of the property. If name includes \".\"s, it may be interpreted as a property name path.", + "description": "A reference to a property. Requires: * MUST be a dot-delimited (`.`) string of segments, where each segment conforms to entity property name limitations.", "type": "string" } }, diff --git a/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index c2265bbea01..916dddb4ae5 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -2211,8 +2211,9 @@ func (s *PropertyOrder) MarshalJSON() ([]byte, error) { // PropertyReference: A reference to a property relative to the kind // expressions. type PropertyReference struct { - // Name: The name of the property. If name includes "."s, it may be - // interpreted as a property name path. + // Name: A reference to a property. Requires: * MUST be a dot-delimited + // (`.`) string of segments, where each segment conforms to entity + // property name limitations. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to diff --git a/domains/v1/domains-api.json b/domains/v1/domains-api.json index cb76a26c933..dc11167333c 100644 --- a/domains/v1/domains-api.json +++ b/domains/v1/domains-api.json @@ -843,7 +843,7 @@ } } }, - "revision": "20230503", + "revision": "20230904", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1495,7 +1495,7 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object" } }, @@ -1535,7 +1535,7 @@ "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/).", + "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", "properties": { "auditConfigs": { diff --git a/domains/v1/domains-gen.go b/domains/v1/domains-gen.go index c6e12b35c38..6999e20a422 100644 --- a/domains/v1/domains-gen.go +++ b/domains/v1/domains-gen.go @@ -1309,8 +1309,8 @@ type Operation struct { // `operations/{unique_id}`. Name string `json:"name,omitempty"` - // Response: The normal response of the operation in case of success. If - // the original method returns no data on success, such as `Delete`, the + // Response: The normal, successful response of the operation. If the + // original method returns no data on success, such as `Delete`, the // response is `google.protobuf.Empty`. If the original method is // standard `Get`/`Create`/`Update`, the response should be the // resource. For other methods, the response should have the type @@ -1404,7 +1404,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // 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": +// **JSON example:** ``` { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1413,17 +1413,17 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // "user:eve@example.com" ], "condition": { "title": "expirable access", // "description": "Does not grant access after Sep 2020", "expression": // "request.time < 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 - +// "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 < // 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/). +// ``` For a description of IAM and its features, see the IAM +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. diff --git a/domains/v1alpha2/domains-api.json b/domains/v1alpha2/domains-api.json index 2f9dbb70bcb..b8a5f595b24 100644 --- a/domains/v1alpha2/domains-api.json +++ b/domains/v1alpha2/domains-api.json @@ -843,7 +843,7 @@ } } }, - "revision": "20230503", + "revision": "20230904", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1495,7 +1495,7 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object" } }, @@ -1535,7 +1535,7 @@ "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/).", + "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", "properties": { "auditConfigs": { diff --git a/domains/v1alpha2/domains-gen.go b/domains/v1alpha2/domains-gen.go index 0b91d9c0fb3..78be5b50269 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -1309,8 +1309,8 @@ type Operation struct { // `operations/{unique_id}`. Name string `json:"name,omitempty"` - // Response: The normal response of the operation in case of success. If - // the original method returns no data on success, such as `Delete`, the + // Response: The normal, successful response of the operation. If the + // original method returns no data on success, such as `Delete`, the // response is `google.protobuf.Empty`. If the original method is // standard `Get`/`Create`/`Update`, the response should be the // resource. For other methods, the response should have the type @@ -1404,7 +1404,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // 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": +// **JSON example:** ``` { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1413,17 +1413,17 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // "user:eve@example.com" ], "condition": { "title": "expirable access", // "description": "Does not grant access after Sep 2020", "expression": // "request.time < 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 - +// "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 < // 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/). +// ``` For a description of IAM and its features, see the IAM +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. diff --git a/domains/v1beta1/domains-api.json b/domains/v1beta1/domains-api.json index 620e70b959a..b46fbc61815 100644 --- a/domains/v1beta1/domains-api.json +++ b/domains/v1beta1/domains-api.json @@ -843,7 +843,7 @@ } } }, - "revision": "20230503", + "revision": "20230904", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1495,7 +1495,7 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object" } }, @@ -1535,7 +1535,7 @@ "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/).", + "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", "properties": { "auditConfigs": { diff --git a/domains/v1beta1/domains-gen.go b/domains/v1beta1/domains-gen.go index efc2e47b0d6..fd4babcf308 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -1309,8 +1309,8 @@ type Operation struct { // `operations/{unique_id}`. Name string `json:"name,omitempty"` - // Response: The normal response of the operation in case of success. If - // the original method returns no data on success, such as `Delete`, the + // Response: The normal, successful response of the operation. If the + // original method returns no data on success, such as `Delete`, the // response is `google.protobuf.Empty`. If the original method is // standard `Get`/`Create`/`Update`, the response should be the // resource. For other methods, the response should have the type @@ -1404,7 +1404,7 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // 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": +// **JSON example:** ``` { "bindings": [ { "role": // "roles/resourcemanager.organizationAdmin", "members": [ // "user:mike@example.com", "group:admins@example.com", // "domain:google.com", @@ -1413,17 +1413,17 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { // "user:eve@example.com" ], "condition": { "title": "expirable access", // "description": "Does not grant access after Sep 2020", "expression": // "request.time < 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 - +// "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 < // 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/). +// ``` For a description of IAM and its features, see the IAM +// documentation (https://cloud.google.com/iam/docs/). type Policy struct { // AuditConfigs: Specifies cloud audit logging configuration for this // policy. diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index 23302830294..8af992dbe11 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -323,7 +323,7 @@ ] }, "restore": { - "description": "Create a new database by restore from an existing backup. The new database must be in the same cloud region or multi-region location as the existing backup. This behaves similar to FirestoreAdmin.CreateDatabase except instead of creating a new empty database, a new database is created with the database type, index configuration, and documents from an existing backup. The long-running operation can be used to track the progress of the restore, with the Operation's metadata field type being the RestoreDatabaseMetadata. The response type is the Database if the restore was successful. The new database is not readable or writeable until the LRO has completed. Cancelling the returned operation will stop the restore and delete the in-progress database, if the restore is still active.", + "description": "Creates a new database by restoring from an existing backup. The new database must be in the same cloud region or multi-region location as the existing backup. This behaves similar to FirestoreAdmin.CreateDatabase except instead of creating a new empty database, a new database is created with the database type, index configuration, and documents from an existing backup. The long-running operation can be used to track the progress of the restore, with the Operation's metadata field type being the RestoreDatabaseMetadata. The response type is the Database if the restore was successful. The new database is not readable or writeable until the LRO has completed.", "flatPath": "v1/projects/{projectsId}/databases:restore", "httpMethod": "POST", "id": "firestore.projects.databases.restore", @@ -1672,7 +1672,7 @@ } } }, - "revision": "20230806", + "revision": "20230905", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -2016,7 +2016,6 @@ "additionalProperties": { "$ref": "Value" }, - "description": "The document's fields. The map keys represent field names. A simple field name contains only characters `a` to `z`, `A` to `Z`, `0` to `9`, or `_`, and must not start with `0` to `9`. For example, `foo_bar_17`. Field names matching the regular expression `__.*__` are reserved. Reserved field names are forbidden except in certain documented contexts. The map keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be empty. Field paths may be used in other contexts to refer to structured fields defined here. For `map_value`, the field path is represented by the simple or quoted field names of the containing fields, delimited by `.`. For example, the structured field `\"foo\" : { map_value: { \"x\u0026y\" : { string_value: \"hello\" }}}` would be represented by the field path `foo.x\u0026y`. Within a field path, a quoted field name starts and ends with `` ` `` and may contain any character. Some characters, including `` ` ``, must be escaped using a `\\`. For example, `` `x\u0026y` `` represents `x\u0026y` and `` `bak\\`tik` `` represents `` bak`tik ``.", "type": "object" }, "name": { @@ -2229,7 +2228,7 @@ "id": "FieldReference", "properties": { "fieldPath": { - "description": "The relative path of the document being referenced. Requires: * Conform to document field name limitations.", + "description": "A reference to a field in a document. Requires: * MUST be a dot-delimited (`.`) string of segments, where each segment conforms to document field name limitations.", "type": "string" } }, @@ -2298,7 +2297,7 @@ "type": "object" }, "GoogleFirestoreAdminV1Backup": { - "description": "A Backup of a Cloud Firestore Database. The backup contains all documents and index configurations for the given database at specific point in time.", + "description": "A Backup of a Cloud Firestore Database. The backup contains all documents and index configurations for the given database at a specific point in time.", "id": "GoogleFirestoreAdminV1Backup", "properties": { "database": { @@ -2390,6 +2389,12 @@ }, "type": "object" }, + "GoogleFirestoreAdminV1CreateDatabaseMetadata": { + "description": "Metadata related to the create database operation.", + "id": "GoogleFirestoreAdminV1CreateDatabaseMetadata", + "properties": {}, + "type": "object" + }, "GoogleFirestoreAdminV1DailyRecurrence": { "description": "Represent a recurring schedule that runs at a specific time every day. The time zone is UTC.", "id": "GoogleFirestoreAdminV1DailyRecurrence", @@ -2397,7 +2402,7 @@ "type": "object" }, "GoogleFirestoreAdminV1Database": { - "description": "A Cloud Firestore Database. Currently only one database is allowed per cloud project; this database must have a `database_id` of '(default)'.", + "description": "A Cloud Firestore Database.", "id": "GoogleFirestoreAdminV1Database", "properties": { "appEngineIntegrationMode": { @@ -2521,6 +2526,12 @@ }, "type": "object" }, + "GoogleFirestoreAdminV1DeleteDatabaseMetadata": { + "description": "Metadata related to the delete database operation.", + "id": "GoogleFirestoreAdminV1DeleteDatabaseMetadata", + "properties": {}, + "type": "object" + }, "GoogleFirestoreAdminV1ExportDocumentsMetadata": { "description": "Metadata for google.longrunning.Operation results from FirestoreAdmin.ExportDocuments.", "id": "GoogleFirestoreAdminV1ExportDocumentsMetadata", @@ -3934,7 +3945,7 @@ "type": "string" }, "targetId": { - "description": "The target ID that identifies the target on the stream. Must be a positive number and non-zero.", + "description": "The target ID that identifies the target on the stream. Must be a positive number and non-zero. If `target_id` is 0 (or unspecified), the server will assign an ID for this target and return that in a `TargetChange::ADD` event. Once a target with `target_id=0` is added, all subsequent targets must also have `target_id=0`. If an `AddTarget` request with `target_id != 0` is sent to the server after a target with `target_id=0` is added, the server will immediately send a response with a `TargetChange::Remove` event. Note that if the client sends multiple `AddTarget` requests without an ID, the order of IDs returned in `TargetChage.target_ids` are undefined. Therefore, clients should provide a target ID instead of relying on the server to assign one. If `target_id` is non-zero, there must not be an existing active target on this stream with the same ID.", "format": "int32", "type": "integer" } diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index d837a34ad00..7454c2ab0ad 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -962,22 +962,6 @@ type Document struct { // the `read_time` of a query. CreateTime string `json:"createTime,omitempty"` - // Fields: The document's fields. The map keys represent field names. A - // simple field name contains only characters `a` to `z`, `A` to `Z`, - // `0` to `9`, or `_`, and must not start with `0` to `9`. For example, - // `foo_bar_17`. Field names matching the regular expression `__.*__` - // are reserved. Reserved field names are forbidden except in certain - // documented contexts. The map keys, represented as UTF-8, must not - // exceed 1,500 bytes and cannot be empty. Field paths may be used in - // other contexts to refer to structured fields defined here. For - // `map_value`, the field path is represented by the simple or quoted - // field names of the containing fields, delimited by `.`. For example, - // the structured field "foo" : { map_value: { "x&y" : { string_value: - // "hello" }}}` would be represented by the field path `foo.x&y`. Within - // a field path, a quoted field name starts and ends with `` ` `` and - // may contain any character. Some characters, including `` ` ``, must - // be escaped using a `\`. For example, `` `x&y` `` represents `x&y` and - // `` `bak\`tik` `` represents `` bak`tik ``. Fields map[string]Value `json:"fields,omitempty"` // Name: The resource name of the document, for example @@ -1365,8 +1349,9 @@ func (s *FieldFilter) MarshalJSON() ([]byte, error) { // FieldReference: A reference to a field in a document, ex: // `stats.operations`. type FieldReference struct { - // FieldPath: The relative path of the document being referenced. - // Requires: * Conform to document field name limitations. + // FieldPath: A reference to a field in a document. Requires: * MUST be + // a dot-delimited (`.`) string of segments, where each segment conforms + // to document field name limitations. FieldPath string `json:"fieldPath,omitempty"` // ForceSendFields is a list of field names (e.g. "FieldPath") to @@ -1528,7 +1513,7 @@ func (s *Filter) MarshalJSON() ([]byte, error) { // GoogleFirestoreAdminV1Backup: A Backup of a Cloud Firestore Database. // The backup contains all documents and index configurations for the -// given database at specific point in time. +// given database at a specific point in time. type GoogleFirestoreAdminV1Backup struct { // Database: Output only. Name of the Firestore database that the backup // is from. Format is `projects/{project}/databases/{database}`. @@ -1652,14 +1637,17 @@ func (s *GoogleFirestoreAdminV1BackupSchedule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirestoreAdminV1CreateDatabaseMetadata: Metadata related to the +// create database operation. +type GoogleFirestoreAdminV1CreateDatabaseMetadata struct { +} + // GoogleFirestoreAdminV1DailyRecurrence: Represent a recurring schedule // that runs at a specific time every day. The time zone is UTC. type GoogleFirestoreAdminV1DailyRecurrence struct { } -// GoogleFirestoreAdminV1Database: A Cloud Firestore Database. Currently -// only one database is allowed per cloud project; this database must -// have a `database_id` of '(default)'. +// GoogleFirestoreAdminV1Database: A Cloud Firestore Database. type GoogleFirestoreAdminV1Database struct { // AppEngineIntegrationMode: The App Engine integration mode to use for // this database. @@ -1806,6 +1794,11 @@ func (s *GoogleFirestoreAdminV1Database) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirestoreAdminV1DeleteDatabaseMetadata: Metadata related to the +// delete database operation. +type GoogleFirestoreAdminV1DeleteDatabaseMetadata struct { +} + // GoogleFirestoreAdminV1ExportDocumentsMetadata: Metadata for // google.longrunning.Operation results from // FirestoreAdmin.ExportDocuments. @@ -4229,7 +4222,18 @@ type Target struct { ResumeToken string `json:"resumeToken,omitempty"` // TargetId: The target ID that identifies the target on the stream. - // Must be a positive number and non-zero. + // Must be a positive number and non-zero. If `target_id` is 0 (or + // unspecified), the server will assign an ID for this target and return + // that in a `TargetChange::ADD` event. Once a target with `target_id=0` + // is added, all subsequent targets must also have `target_id=0`. If an + // `AddTarget` request with `target_id != 0` is sent to the server after + // a target with `target_id=0` is added, the server will immediately + // send a response with a `TargetChange::Remove` event. Note that if the + // client sends multiple `AddTarget` requests without an ID, the order + // of IDs returned in `TargetChage.target_ids` are undefined. Therefore, + // clients should provide a target ID instead of relying on the server + // to assign one. If `target_id` is non-zero, there must not be an + // existing active target on this stream with the same ID. TargetId int64 `json:"targetId,omitempty"` // ForceSendFields is a list of field names (e.g. "Documents") to @@ -5747,7 +5751,7 @@ type ProjectsDatabasesRestoreCall struct { header_ http.Header } -// Restore: Create a new database by restore from an existing backup. +// Restore: Creates a new database by restoring from an existing backup. // The new database must be in the same cloud region or multi-region // location as the existing backup. This behaves similar to // FirestoreAdmin.CreateDatabase except instead of creating a new empty @@ -5757,9 +5761,7 @@ type ProjectsDatabasesRestoreCall struct { // restore, with the Operation's metadata field type being the // RestoreDatabaseMetadata. The response type is the Database if the // restore was successful. The new database is not readable or writeable -// until the LRO has completed. Cancelling the returned operation will -// stop the restore and delete the in-progress database, if the restore -// is still active. +// until the LRO has completed. // // - parent: The project to restore the database in. Format is // `projects/{project_id}`. @@ -5861,7 +5863,7 @@ func (c *ProjectsDatabasesRestoreCall) Do(opts ...googleapi.CallOption) (*Google } return ret, nil // { - // "description": "Create a new database by restore from an existing backup. The new database must be in the same cloud region or multi-region location as the existing backup. This behaves similar to FirestoreAdmin.CreateDatabase except instead of creating a new empty database, a new database is created with the database type, index configuration, and documents from an existing backup. The long-running operation can be used to track the progress of the restore, with the Operation's metadata field type being the RestoreDatabaseMetadata. The response type is the Database if the restore was successful. The new database is not readable or writeable until the LRO has completed. Cancelling the returned operation will stop the restore and delete the in-progress database, if the restore is still active.", + // "description": "Creates a new database by restoring from an existing backup. The new database must be in the same cloud region or multi-region location as the existing backup. This behaves similar to FirestoreAdmin.CreateDatabase except instead of creating a new empty database, a new database is created with the database type, index configuration, and documents from an existing backup. The long-running operation can be used to track the progress of the restore, with the Operation's metadata field type being the RestoreDatabaseMetadata. The response type is the Database if the restore was successful. The new database is not readable or writeable until the LRO has completed.", // "flatPath": "v1/projects/{projectsId}/databases:restore", // "httpMethod": "POST", // "id": "firestore.projects.databases.restore", diff --git a/firestore/v1beta1/firestore-api.json b/firestore/v1beta1/firestore-api.json index 2b7919b1701..7c9101a1c6c 100644 --- a/firestore/v1beta1/firestore-api.json +++ b/firestore/v1beta1/firestore-api.json @@ -950,7 +950,7 @@ } } }, - "revision": "20230806", + "revision": "20230905", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -1294,7 +1294,6 @@ "additionalProperties": { "$ref": "Value" }, - "description": "The document's fields. The map keys represent field names. A simple field name contains only characters `a` to `z`, `A` to `Z`, `0` to `9`, or `_`, and must not start with `0` to `9`. For example, `foo_bar_17`. Field names matching the regular expression `__.*__` are reserved. Reserved field names are forbidden except in certain documented contexts. The map keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be empty. Field paths may be used in other contexts to refer to structured fields defined here. For `map_value`, the field path is represented by the simple or quoted field names of the containing fields, delimited by `.`. For example, the structured field `\"foo\" : { map_value: { \"x\u0026y\" : { string_value: \"hello\" }}}` would be represented by the field path `foo.x\u0026y`. Within a field path, a quoted field name starts and ends with `` ` `` and may contain any character. Some characters, including `` ` ``, must be escaped using a `\\`. For example, `` `x\u0026y` `` represents `x\u0026y` and `` `bak\\`tik` `` represents `` bak`tik ``.", "type": "object" }, "name": { @@ -1507,7 +1506,7 @@ "id": "FieldReference", "properties": { "fieldPath": { - "description": "The relative path of the document being referenced. Requires: * Conform to document field name limitations.", + "description": "A reference to a field in a document. Requires: * MUST be a dot-delimited (`.`) string of segments, where each segment conforms to document field name limitations.", "type": "string" } }, @@ -1575,6 +1574,18 @@ }, "type": "object" }, + "GoogleFirestoreAdminV1CreateDatabaseMetadata": { + "description": "Metadata related to the create database operation.", + "id": "GoogleFirestoreAdminV1CreateDatabaseMetadata", + "properties": {}, + "type": "object" + }, + "GoogleFirestoreAdminV1DeleteDatabaseMetadata": { + "description": "Metadata related to the delete database operation.", + "id": "GoogleFirestoreAdminV1DeleteDatabaseMetadata", + "properties": {}, + "type": "object" + }, "GoogleFirestoreAdminV1Progress": { "description": "Describes the progress of the operation. Unit of work is generic and must be interpreted based on where Progress is used.", "id": "GoogleFirestoreAdminV1Progress", @@ -2528,7 +2539,7 @@ "type": "string" }, "targetId": { - "description": "The target ID that identifies the target on the stream. Must be a positive number and non-zero.", + "description": "The target ID that identifies the target on the stream. Must be a positive number and non-zero. If `target_id` is 0 (or unspecified), the server will assign an ID for this target and return that in a `TargetChange::ADD` event. Once a target with `target_id=0` is added, all subsequent targets must also have `target_id=0`. If an `AddTarget` request with `target_id != 0` is sent to the server after a target with `target_id=0` is added, the server will immediately send a response with a `TargetChange::Remove` event. Note that if the client sends multiple `AddTarget` requests without an ID, the order of IDs returned in `TargetChage.target_ids` are undefined. Therefore, clients should provide a target ID instead of relying on the server to assign one. If `target_id` is non-zero, there must not be an existing active target on this stream with the same ID.", "format": "int32", "type": "integer" } diff --git a/firestore/v1beta1/firestore-gen.go b/firestore/v1beta1/firestore-gen.go index e50f1a1aec5..8d68b2d67e4 100644 --- a/firestore/v1beta1/firestore-gen.go +++ b/firestore/v1beta1/firestore-gen.go @@ -890,22 +890,6 @@ type Document struct { // the `read_time` of a query. CreateTime string `json:"createTime,omitempty"` - // Fields: The document's fields. The map keys represent field names. A - // simple field name contains only characters `a` to `z`, `A` to `Z`, - // `0` to `9`, or `_`, and must not start with `0` to `9`. For example, - // `foo_bar_17`. Field names matching the regular expression `__.*__` - // are reserved. Reserved field names are forbidden except in certain - // documented contexts. The map keys, represented as UTF-8, must not - // exceed 1,500 bytes and cannot be empty. Field paths may be used in - // other contexts to refer to structured fields defined here. For - // `map_value`, the field path is represented by the simple or quoted - // field names of the containing fields, delimited by `.`. For example, - // the structured field "foo" : { map_value: { "x&y" : { string_value: - // "hello" }}}` would be represented by the field path `foo.x&y`. Within - // a field path, a quoted field name starts and ends with `` ` `` and - // may contain any character. Some characters, including `` ` ``, must - // be escaped using a `\`. For example, `` `x&y` `` represents `x&y` and - // `` `bak\`tik` `` represents `` bak`tik ``. Fields map[string]Value `json:"fields,omitempty"` // Name: The resource name of the document, for example @@ -1293,8 +1277,9 @@ func (s *FieldFilter) MarshalJSON() ([]byte, error) { // FieldReference: A reference to a field in a document, ex: // `stats.operations`. type FieldReference struct { - // FieldPath: The relative path of the document being referenced. - // Requires: * Conform to document field name limitations. + // FieldPath: A reference to a field in a document. Requires: * MUST be + // a dot-delimited (`.`) string of segments, where each segment conforms + // to document field name limitations. FieldPath string `json:"fieldPath,omitempty"` // ForceSendFields is a list of field names (e.g. "FieldPath") to @@ -1454,6 +1439,16 @@ func (s *Filter) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirestoreAdminV1CreateDatabaseMetadata: Metadata related to the +// create database operation. +type GoogleFirestoreAdminV1CreateDatabaseMetadata struct { +} + +// GoogleFirestoreAdminV1DeleteDatabaseMetadata: Metadata related to the +// delete database operation. +type GoogleFirestoreAdminV1DeleteDatabaseMetadata struct { +} + // GoogleFirestoreAdminV1Progress: Describes the progress of the // operation. Unit of work is generic and must be interpreted based on // where Progress is used. @@ -3125,7 +3120,18 @@ type Target struct { ResumeToken string `json:"resumeToken,omitempty"` // TargetId: The target ID that identifies the target on the stream. - // Must be a positive number and non-zero. + // Must be a positive number and non-zero. If `target_id` is 0 (or + // unspecified), the server will assign an ID for this target and return + // that in a `TargetChange::ADD` event. Once a target with `target_id=0` + // is added, all subsequent targets must also have `target_id=0`. If an + // `AddTarget` request with `target_id != 0` is sent to the server after + // a target with `target_id=0` is added, the server will immediately + // send a response with a `TargetChange::Remove` event. Note that if the + // client sends multiple `AddTarget` requests without an ID, the order + // of IDs returned in `TargetChage.target_ids` are undefined. Therefore, + // clients should provide a target ID instead of relying on the server + // to assign one. If `target_id` is non-zero, there must not be an + // existing active target on this stream with the same ID. TargetId int64 `json:"targetId,omitempty"` // ForceSendFields is a list of field names (e.g. "Documents") to diff --git a/firestore/v1beta2/firestore-api.json b/firestore/v1beta2/firestore-api.json index cbd6c3afc8b..ce69a03fb7a 100644 --- a/firestore/v1beta2/firestore-api.json +++ b/firestore/v1beta2/firestore-api.json @@ -415,7 +415,7 @@ } } }, - "revision": "20230806", + "revision": "20230905", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Empty": { @@ -424,6 +424,18 @@ "properties": {}, "type": "object" }, + "GoogleFirestoreAdminV1CreateDatabaseMetadata": { + "description": "Metadata related to the create database operation.", + "id": "GoogleFirestoreAdminV1CreateDatabaseMetadata", + "properties": {}, + "type": "object" + }, + "GoogleFirestoreAdminV1DeleteDatabaseMetadata": { + "description": "Metadata related to the delete database operation.", + "id": "GoogleFirestoreAdminV1DeleteDatabaseMetadata", + "properties": {}, + "type": "object" + }, "GoogleFirestoreAdminV1Progress": { "description": "Describes the progress of the operation. Unit of work is generic and must be interpreted based on where Progress is used.", "id": "GoogleFirestoreAdminV1Progress", diff --git a/firestore/v1beta2/firestore-gen.go b/firestore/v1beta2/firestore-gen.go index c4f3d0e31c6..3216b824541 100644 --- a/firestore/v1beta2/firestore-gen.go +++ b/firestore/v1beta2/firestore-gen.go @@ -230,6 +230,16 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } +// GoogleFirestoreAdminV1CreateDatabaseMetadata: Metadata related to the +// create database operation. +type GoogleFirestoreAdminV1CreateDatabaseMetadata struct { +} + +// GoogleFirestoreAdminV1DeleteDatabaseMetadata: Metadata related to the +// delete database operation. +type GoogleFirestoreAdminV1DeleteDatabaseMetadata struct { +} + // GoogleFirestoreAdminV1Progress: Describes the progress of the // operation. Unit of work is generic and must be interpreted based on // where Progress is used. diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index 80a2a7ff3f8..81255568b9c 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-api.json @@ -1834,7 +1834,7 @@ } } }, - "revision": "20230814", + "revision": "20230901", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -1923,7 +1923,7 @@ "type": "string" }, "issuer": { - "description": "Optional. A JSON Web Token (JWT) issuer URI. `issuer` must start with `https://` and be a valid URL with length \u003c2000 characters. If set, then Google will allow valid OIDC tokens from this issuer to authenticate within the workload_identity_pool. OIDC discovery will be performed on this URI to validate tokens from the issuer. Clearing `issuer` disables Workload Identity. `issuer` cannot be directly modified; it must be cleared (and Workload Identity disabled) before using a new issuer (and re-enabling Workload Identity).", + "description": "Optional. A JSON Web Token (JWT) issuer URI. `issuer` must start with `https://` and be a valid URL with length \u003c2000 characters, it must use `location` rather than `zone` for GKE clusters. If set, then Google will allow valid OIDC tokens from this issuer to authenticate within the workload_identity_pool. OIDC discovery will be performed on this URI to validate tokens from the issuer. Clearing `issuer` disables Workload Identity. `issuer` cannot be directly modified; it must be cleared (and Workload Identity disabled) before using a new issuer (and re-enabling Workload Identity).", "type": "string" }, "oidcJwks": { @@ -3352,10 +3352,6 @@ "tenant": { "description": "Kind of Azure AD account to be authenticated. Supported values are or for accounts belonging to a specific tenant.", "type": "string" - }, - "userClaim": { - "description": "Optional. Claim in the AzureAD ID Token that holds the user details.", - "type": "string" } }, "type": "object" diff --git a/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index e18fa9aaeca..5967c378d25 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -479,8 +479,9 @@ type Authority struct { // Issuer: Optional. A JSON Web Token (JWT) issuer URI. `issuer` must // start with `https://` and be a valid URL with length <2000 - // characters. If set, then Google will allow valid OIDC tokens from - // this issuer to authenticate within the workload_identity_pool. OIDC + // characters, it must use `location` rather than `zone` for GKE + // clusters. If set, then Google will allow valid OIDC tokens from this + // issuer to authenticate within the workload_identity_pool. OIDC // discovery will be performed on this URI to validate tokens from the // issuer. Clearing `issuer` disables Workload Identity. `issuer` cannot // be directly modified; it must be cleared (and Workload Identity @@ -2737,10 +2738,6 @@ type IdentityServiceAzureADConfig struct { // values are or for accounts belonging to a specific tenant. Tenant string `json:"tenant,omitempty"` - // UserClaim: Optional. Claim in the AzureAD ID Token that holds the - // user details. - UserClaim string `json:"userClaim,omitempty"` - // ForceSendFields is a list of field names (e.g. "ClientId") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index 7bb614dc1a4..9e7fa016eaf 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -2414,7 +2414,7 @@ } } }, - "revision": "20230814", + "revision": "20230901", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2533,7 +2533,7 @@ "type": "string" }, "issuer": { - "description": "Optional. A JSON Web Token (JWT) issuer URI. `issuer` must start with `https://` and be a valid URL with length \u003c2000 characters. If set, then Google will allow valid OIDC tokens from this issuer to authenticate within the workload_identity_pool. OIDC discovery will be performed on this URI to validate tokens from the issuer. Clearing `issuer` disables Workload Identity. `issuer` cannot be directly modified; it must be cleared (and Workload Identity disabled) before using a new issuer (and re-enabling Workload Identity).", + "description": "Optional. A JSON Web Token (JWT) issuer URI. `issuer` must start with `https://` and be a valid URL with length \u003c2000 characters, it must use `location` rather than `zone` for GKE clusters. If set, then Google will allow valid OIDC tokens from this issuer to authenticate within the workload_identity_pool. OIDC discovery will be performed on this URI to validate tokens from the issuer. Clearing `issuer` disables Workload Identity. `issuer` cannot be directly modified; it must be cleared (and Workload Identity disabled) before using a new issuer (and re-enabling Workload Identity).", "type": "string" }, "oidcJwks": { @@ -3520,7 +3520,8 @@ "properties": { "binauthz": { "$ref": "ConfigManagementBinauthzConfig", - "description": "Binauthz conifguration for the cluster." + "deprecated": true, + "description": "Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." }, "cluster": { "description": "The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", @@ -4435,10 +4436,6 @@ "tenant": { "description": "Kind of Azure AD account to be authenticated. Supported values are or for accounts belonging to a specific tenant.", "type": "string" - }, - "userClaim": { - "description": "Optional. Claim in the AzureAD ID Token that holds the user details.", - "type": "string" } }, "type": "object" diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 6d48c6d8d24..f23c329be98 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -586,8 +586,9 @@ type Authority struct { // Issuer: Optional. A JSON Web Token (JWT) issuer URI. `issuer` must // start with `https://` and be a valid URL with length <2000 - // characters. If set, then Google will allow valid OIDC tokens from - // this issuer to authenticate within the workload_identity_pool. OIDC + // characters, it must use `location` rather than `zone` for GKE + // clusters. If set, then Google will allow valid OIDC tokens from this + // issuer to authenticate within the workload_identity_pool. OIDC // discovery will be performed on this URI to validate tokens from the // issuer. Clearing `issuer` disables Workload Identity. `issuer` cannot // be directly modified; it must be cleared (and Workload Identity @@ -2202,7 +2203,8 @@ func (s *ConfigManagementInstallError) MarshalJSON() ([]byte, error) { // Configuration for a single cluster. Intended to parallel the // ConfigManagement CR. type ConfigManagementMembershipSpec struct { - // Binauthz: Binauthz conifguration for the cluster. + // Binauthz: Binauthz conifguration for the cluster. Deprecated: This + // field will be ignored and should not be set. Binauthz *ConfigManagementBinauthzConfig `json:"binauthz,omitempty"` // Cluster: The user-specified cluster name used by Config Sync @@ -3678,10 +3680,6 @@ type IdentityServiceAzureADConfig struct { // values are or for accounts belonging to a specific tenant. Tenant string `json:"tenant,omitempty"` - // UserClaim: Optional. Claim in the AzureAD ID Token that holds the - // user details. - UserClaim string `json:"userClaim,omitempty"` - // ForceSendFields is a list of field names (e.g. "ClientId") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index 92fe4da7387..c7cba260548 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -2100,7 +2100,7 @@ } } }, - "revision": "20230814", + "revision": "20230901", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2802,7 +2802,8 @@ "properties": { "binauthz": { "$ref": "ConfigManagementBinauthzConfig", - "description": "Binauthz conifguration for the cluster." + "deprecated": true, + "description": "Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." }, "cluster": { "description": "The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", @@ -3632,10 +3633,6 @@ "tenant": { "description": "Kind of Azure AD account to be authenticated. Supported values are or for accounts belonging to a specific tenant.", "type": "string" - }, - "userClaim": { - "description": "Optional. Claim in the AzureAD ID Token that holds the user details.", - "type": "string" } }, "type": "object" diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index 926649ef1e8..74329042b3f 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1486,7 +1486,8 @@ func (s *ConfigManagementInstallError) MarshalJSON() ([]byte, error) { // Configuration for a single cluster. Intended to parallel the // ConfigManagement CR. type ConfigManagementMembershipSpec struct { - // Binauthz: Binauthz conifguration for the cluster. + // Binauthz: Binauthz conifguration for the cluster. Deprecated: This + // field will be ignored and should not be set. Binauthz *ConfigManagementBinauthzConfig `json:"binauthz,omitempty"` // Cluster: The user-specified cluster name used by Config Sync @@ -2781,10 +2782,6 @@ type IdentityServiceAzureADConfig struct { // values are or for accounts belonging to a specific tenant. Tenant string `json:"tenant,omitempty"` - // UserClaim: Optional. Claim in the AzureAD ID Token that holds the - // user details. - UserClaim string `json:"userClaim,omitempty"` - // ForceSendFields is a list of field names (e.g. "ClientId") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/networkconnectivity/v1/networkconnectivity-api.json b/networkconnectivity/v1/networkconnectivity-api.json index d62d9101a05..2809422706e 100644 --- a/networkconnectivity/v1/networkconnectivity-api.json +++ b/networkconnectivity/v1/networkconnectivity-api.json @@ -181,6 +181,34 @@ "resources": { "hubs": { "methods": { + "acceptSpoke": { + "description": "Accepts a proposal to attach a Network Connectivity Center spoke to the hub.", + "flatPath": "v1/projects/{projectsId}/locations/global/hubs/{hubsId}:acceptSpoke", + "httpMethod": "POST", + "id": "networkconnectivity.projects.locations.global.hubs.acceptSpoke", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the hub.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/hubs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:acceptSpoke", + "request": { + "$ref": "AcceptHubSpokeRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Creates a new Network Connectivity Center hub in the specified project.", "flatPath": "v1/projects/{projectsId}/locations/global/hubs", @@ -457,6 +485,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "rejectSpoke": { + "description": "Rejects a Network Connectivity Center spoke from being attached to the hub. If the spoke was previously in the `ACTIVE` state, it transitions to the `INACTIVE` state and is no longer able to connect to other spokes that are attached to the hub.", + "flatPath": "v1/projects/{projectsId}/locations/global/hubs/{hubsId}:rejectSpoke", + "httpMethod": "POST", + "id": "networkconnectivity.projects.locations.global.hubs.rejectSpoke", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the hub.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/hubs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:rejectSpoke", + "request": { + "$ref": "RejectHubSpokeRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1/projects/{projectsId}/locations/global/hubs/{hubsId}:setIamPolicy", @@ -2630,9 +2686,24 @@ } } }, - "revision": "20230816", + "revision": "20230831", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { + "AcceptHubSpokeRequest": { + "description": "The request for HubService.AcceptHubSpoke.", + "id": "AcceptHubSpokeRequest", + "properties": { + "requestId": { + "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly creating duplicate commitments. The request ID must be a valid UUID, with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "type": "string" + }, + "spokeUri": { + "description": "Required. The URI of the spoke to accept into the hub.", + "type": "string" + } + }, + "type": "object" + }, "AcceptSpokeRequest": { "description": "The request for HubService.AcceptSpoke.", "id": "AcceptSpokeRequest", @@ -3015,7 +3086,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Labels in key:value format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", + "description": "Optional. Labels in key-value pair format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", "type": "object" }, "name": { @@ -3081,7 +3152,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional labels in key:value format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", + "description": "Optional labels in key-value pair format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", "type": "object" }, "name": { @@ -4005,6 +4076,25 @@ }, "type": "object" }, + "RejectHubSpokeRequest": { + "description": "The request for HubService.RejectHubSpoke.", + "id": "RejectHubSpokeRequest", + "properties": { + "details": { + "description": "Optional. Additional information provided by the hub administrator.", + "type": "string" + }, + "requestId": { + "description": "Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly creating duplicate commitments. The request ID must be a valid UUID, with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "type": "string" + }, + "spokeUri": { + "description": "Required. The URI of the spoke to reject from the hub.", + "type": "string" + } + }, + "type": "object" + }, "RejectSpokeRequest": { "description": "The request for HubService.RejectSpoke.", "id": "RejectSpokeRequest", @@ -4042,7 +4132,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional labels in key:value format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", + "description": "Optional labels in key-value pair format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", "type": "object" }, "location": { @@ -4135,7 +4225,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional labels in key:value format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", + "description": "Optional labels in key-value pair format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", "type": "object" }, "name": { @@ -4509,7 +4599,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional labels in key:value format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", + "description": "Optional labels in key-value pair format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).", "type": "object" }, "linkedInterconnectAttachments": { diff --git a/networkconnectivity/v1/networkconnectivity-gen.go b/networkconnectivity/v1/networkconnectivity-gen.go index b01ffc4fb04..2ef37e8b873 100644 --- a/networkconnectivity/v1/networkconnectivity-gen.go +++ b/networkconnectivity/v1/networkconnectivity-gen.go @@ -328,6 +328,48 @@ type ProjectsLocationsSpokesService struct { s *Service } +// AcceptHubSpokeRequest: The request for HubService.AcceptHubSpoke. +type AcceptHubSpokeRequest struct { + // RequestId: Optional. A request ID to identify requests. Specify a + // unique request ID so that if you must retry your request, the server + // will know to ignore the request if it has already been completed. The + // server guarantees that a request doesn't result in creation of + // duplicate commitments for at least 60 minutes. For example, consider + // a situation where you make an initial request and the request times + // out. If you make the request again with the same request ID, the + // server can check to see whether the original operation was received. + // If it was, the server ignores the second request. This behavior + // prevents clients from mistakenly creating duplicate commitments. The + // request ID must be a valid UUID, with the exception that zero UUID is + // not supported (00000000-0000-0000-0000-000000000000). + RequestId string `json:"requestId,omitempty"` + + // SpokeUri: Required. The URI of the spoke to accept into the hub. + SpokeUri string `json:"spokeUri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "RequestId") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "RequestId") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *AcceptHubSpokeRequest) MarshalJSON() ([]byte, error) { + type NoMethod AcceptHubSpokeRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // AcceptSpokeRequest: The request for HubService.AcceptSpoke. type AcceptSpokeRequest struct { // RequestId: Optional. A request ID to identify requests. Specify a @@ -1020,8 +1062,8 @@ type Group struct { // Description: Optional. The description of the group. Description string `json:"description,omitempty"` - // Labels: Optional. Labels in key:value format. For more information - // about labels, see Requirements for labels + // Labels: Optional. Labels in key-value pair format. For more + // information about labels, see Requirements for labels // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements). Labels map[string]string `json:"labels,omitempty"` @@ -1096,8 +1138,8 @@ type Hub struct { // Description: An optional description of the hub. Description string `json:"description,omitempty"` - // Labels: Optional labels in key:value format. For more information - // about labels, see Requirements for labels + // Labels: Optional labels in key-value pair format. For more + // information about labels, see Requirements for labels // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements). Labels map[string]string `json:"labels,omitempty"` @@ -2555,6 +2597,52 @@ func (s *PscConnection) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RejectHubSpokeRequest: The request for HubService.RejectHubSpoke. +type RejectHubSpokeRequest struct { + // Details: Optional. Additional information provided by the hub + // administrator. + Details string `json:"details,omitempty"` + + // RequestId: Optional. A request ID to identify requests. Specify a + // unique request ID so that if you must retry your request, the server + // will know to ignore the request if it has already been completed. The + // server guarantees that a request doesn't result in creation of + // duplicate commitments for at least 60 minutes. For example, consider + // a situation where you make an initial request and the request times + // out. If you make the request again with the same request ID, the + // server can check to see whether the original operation was received. + // If it was, the server ignores the second request. This behavior + // prevents clients from mistakenly creating duplicate commitments. The + // request ID must be a valid UUID, with the exception that zero UUID is + // not supported (00000000-0000-0000-0000-000000000000). + RequestId string `json:"requestId,omitempty"` + + // SpokeUri: Required. The URI of the spoke to reject from the hub. + SpokeUri string `json:"spokeUri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Details") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Details") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *RejectHubSpokeRequest) MarshalJSON() ([]byte, error) { + type NoMethod RejectHubSpokeRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // RejectSpokeRequest: The request for HubService.RejectSpoke. type RejectSpokeRequest struct { // Details: Optional. Additional information provided by the hub @@ -2610,8 +2698,8 @@ type Route struct { // IpCidrRange: The destination IP address range. IpCidrRange string `json:"ipCidrRange,omitempty"` - // Labels: Optional labels in key:value format. For more information - // about labels, see Requirements for labels + // Labels: Optional labels in key-value pair format. For more + // information about labels, see Requirements for labels // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements). Labels map[string]string `json:"labels,omitempty"` @@ -2703,8 +2791,8 @@ type RouteTable struct { // Description: An optional description of the route table. Description string `json:"description,omitempty"` - // Labels: Optional labels in key:value format. For more information - // about labels, see Requirements for labels + // Labels: Optional labels in key-value pair format. For more + // information about labels, see Requirements for labels // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements). Labels map[string]string `json:"labels,omitempty"` @@ -3189,8 +3277,8 @@ type Spoke struct { // Hub: Immutable. The name of the hub that this spoke is attached to. Hub string `json:"hub,omitempty"` - // Labels: Optional labels in key:value format. For more information - // about labels, see Requirements for labels + // Labels: Optional labels in key-value pair format. For more + // information about labels, see Requirements for labels // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements). Labels map[string]string `json:"labels,omitempty"` @@ -3999,6 +4087,149 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat } } +// method id "networkconnectivity.projects.locations.global.hubs.acceptSpoke": + +type ProjectsLocationsGlobalHubsAcceptSpokeCall struct { + s *Service + name string + accepthubspokerequest *AcceptHubSpokeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// AcceptSpoke: Accepts a proposal to attach a Network Connectivity +// Center spoke to the hub. +// +// - name: The name of the hub. +func (r *ProjectsLocationsGlobalHubsService) AcceptSpoke(name string, accepthubspokerequest *AcceptHubSpokeRequest) *ProjectsLocationsGlobalHubsAcceptSpokeCall { + c := &ProjectsLocationsGlobalHubsAcceptSpokeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.accepthubspokerequest = accepthubspokerequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsGlobalHubsAcceptSpokeCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalHubsAcceptSpokeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalHubsAcceptSpokeCall) Context(ctx context.Context) *ProjectsLocationsGlobalHubsAcceptSpokeCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalHubsAcceptSpokeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalHubsAcceptSpokeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.accepthubspokerequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:acceptSpoke") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.global.hubs.acceptSpoke" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsGlobalHubsAcceptSpokeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Accepts a proposal to attach a Network Connectivity Center spoke to the hub.", + // "flatPath": "v1/projects/{projectsId}/locations/global/hubs/{hubsId}:acceptSpoke", + // "httpMethod": "POST", + // "id": "networkconnectivity.projects.locations.global.hubs.acceptSpoke", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the hub.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global/hubs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}:acceptSpoke", + // "request": { + // "$ref": "AcceptHubSpokeRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "networkconnectivity.projects.locations.global.hubs.create": type ProjectsLocationsGlobalHubsCreateCall struct { @@ -5329,6 +5560,151 @@ func (c *ProjectsLocationsGlobalHubsPatchCall) Do(opts ...googleapi.CallOption) } +// method id "networkconnectivity.projects.locations.global.hubs.rejectSpoke": + +type ProjectsLocationsGlobalHubsRejectSpokeCall struct { + s *Service + name string + rejecthubspokerequest *RejectHubSpokeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RejectSpoke: Rejects a Network Connectivity Center spoke from being +// attached to the hub. If the spoke was previously in the `ACTIVE` +// state, it transitions to the `INACTIVE` state and is no longer able +// to connect to other spokes that are attached to the hub. +// +// - name: The name of the hub. +func (r *ProjectsLocationsGlobalHubsService) RejectSpoke(name string, rejecthubspokerequest *RejectHubSpokeRequest) *ProjectsLocationsGlobalHubsRejectSpokeCall { + c := &ProjectsLocationsGlobalHubsRejectSpokeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.rejecthubspokerequest = rejecthubspokerequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsGlobalHubsRejectSpokeCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalHubsRejectSpokeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsGlobalHubsRejectSpokeCall) Context(ctx context.Context) *ProjectsLocationsGlobalHubsRejectSpokeCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsGlobalHubsRejectSpokeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalHubsRejectSpokeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.rejecthubspokerequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:rejectSpoke") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.global.hubs.rejectSpoke" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsGlobalHubsRejectSpokeCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Rejects a Network Connectivity Center spoke from being attached to the hub. If the spoke was previously in the `ACTIVE` state, it transitions to the `INACTIVE` state and is no longer able to connect to other spokes that are attached to the hub.", + // "flatPath": "v1/projects/{projectsId}/locations/global/hubs/{hubsId}:rejectSpoke", + // "httpMethod": "POST", + // "id": "networkconnectivity.projects.locations.global.hubs.rejectSpoke", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the hub.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/global/hubs/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}:rejectSpoke", + // "request": { + // "$ref": "RejectHubSpokeRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "networkconnectivity.projects.locations.global.hubs.setIamPolicy": type ProjectsLocationsGlobalHubsSetIamPolicyCall struct { diff --git a/networksecurity/v1beta1/networksecurity-api.json b/networksecurity/v1beta1/networksecurity-api.json index 516abbdbed8..ea4284ef85b 100644 --- a/networksecurity/v1beta1/networksecurity-api.json +++ b/networksecurity/v1beta1/networksecurity-api.json @@ -506,7 +506,7 @@ ], "parameters": { "filter": { - "description": "Filtering results", + "description": "Optional. Filtering results", "location": "query", "type": "string" }, @@ -516,7 +516,7 @@ "type": "string" }, "pageSize": { - "description": "Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "format": "int32", "location": "query", "type": "integer" @@ -2078,7 +2078,7 @@ ], "parameters": { "filter": { - "description": "Filtering results", + "description": "Optional. Filtering results", "location": "query", "type": "string" }, @@ -2088,7 +2088,7 @@ "type": "string" }, "pageSize": { - "description": "Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "format": "int32", "location": "query", "type": "integer" @@ -3162,7 +3162,7 @@ } } }, - "revision": "20230814", + "revision": "20230831", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -3468,7 +3468,7 @@ "additionalProperties": { "type": "string" }, - "description": "Labels as key value pairs", + "description": "Optional. Labels as key value pairs", "type": "object" }, "name": { @@ -3527,7 +3527,7 @@ "additionalProperties": { "type": "string" }, - "description": "Labels as key value pairs", + "description": "Optional. Labels as key value pairs", "type": "object" }, "name": { diff --git a/networksecurity/v1beta1/networksecurity-gen.go b/networksecurity/v1beta1/networksecurity-gen.go index b7b3aa6adfa..255461f5488 100644 --- a/networksecurity/v1beta1/networksecurity-gen.go +++ b/networksecurity/v1beta1/networksecurity-gen.go @@ -833,7 +833,7 @@ type FirewallEndpoint struct { // CreateTime: Output only. Create time stamp CreateTime string `json:"createTime,omitempty"` - // Labels: Labels as key value pairs + // Labels: Optional. Labels as key value pairs Labels map[string]string `json:"labels,omitempty"` // Name: Output only. name of resource @@ -893,7 +893,7 @@ type FirewallEndpointAssociation struct { // being associated. FirewallEndpoint string `json:"firewallEndpoint,omitempty"` - // Labels: Labels as key value pairs + // Labels: Optional. Labels as key value pairs Labels map[string]string `json:"labels,omitempty"` // Name: Output only. name of resource @@ -5322,7 +5322,7 @@ func (c *OrganizationsLocationsFirewallEndpointsListCall) Do(opts ...googleapi.C // ], // "parameters": { // "filter": { - // "description": "Filtering results", + // "description": "Optional. Filtering results", // "location": "query", // "type": "string" // }, @@ -5332,7 +5332,7 @@ func (c *OrganizationsLocationsFirewallEndpointsListCall) Do(opts ...googleapi.C // "type": "string" // }, // "pageSize": { - // "description": "Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + // "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", // "format": "int32", // "location": "query", // "type": "integer" @@ -13331,7 +13331,7 @@ func (c *ProjectsLocationsFirewallEndpointAssociationsListCall) Do(opts ...googl // ], // "parameters": { // "filter": { - // "description": "Filtering results", + // "description": "Optional. Filtering results", // "location": "query", // "type": "string" // }, @@ -13341,7 +13341,7 @@ func (c *ProjectsLocationsFirewallEndpointAssociationsListCall) Do(opts ...googl // "type": "string" // }, // "pageSize": { - // "description": "Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + // "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", // "format": "int32", // "location": "query", // "type": "integer" diff --git a/tpu/v2alpha1/tpu-api.json b/tpu/v2alpha1/tpu-api.json index a9ebe104fee..def16613c72 100644 --- a/tpu/v2alpha1/tpu-api.json +++ b/tpu/v2alpha1/tpu-api.json @@ -925,7 +925,7 @@ } } }, - "revision": "20230814", + "revision": "20230904", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1824,7 +1824,8 @@ "DELETING", "ACTIVE", "SUSPENDING", - "SUSPENDED" + "SUSPENDED", + "WAITING_FOR_RESOURCES" ], "enumDescriptions": [ "State of the QueuedResource request is not known/set.", @@ -1835,7 +1836,8 @@ "The QueuedResource is being deleted.", "The resources specified in the QueuedResource request have been provisioned and are ready for use by the end-user/consumer.", "The resources specified in the QueuedResource request are being deleted. This may have been initiated by the user, or the Cloud TPU service. Inspect the state data for more details.", - "The resources specified in the QueuedResource request have been deleted." + "The resources specified in the QueuedResource request have been deleted.", + "The QueuedResource request has passed initial validation and has been persisted in the queue. It will remain in this state until there are sufficient free resources to begin provisioning your request. Wait times will vary significantly depending on demand levels. When demand is high, not all requests can be immediately provisioned. If you need more reliable obtainability of TPUs consider purchasing a reservation. To put a limit on how long you are willing to wait, use [timing constraints](https://cloud.google.com/tpu/docs/queued-resources#request_a_queued_resource_before_a_specified_time)." ], "type": "string" }, diff --git a/tpu/v2alpha1/tpu-gen.go b/tpu/v2alpha1/tpu-gen.go index e3fcbc3a045..f497f2857a3 100644 --- a/tpu/v2alpha1/tpu-gen.go +++ b/tpu/v2alpha1/tpu-gen.go @@ -1594,6 +1594,16 @@ type QueuedResourceState struct { // or the Cloud TPU service. Inspect the state data for more details. // "SUSPENDED" - The resources specified in the QueuedResource request // have been deleted. + // "WAITING_FOR_RESOURCES" - The QueuedResource request has passed + // initial validation and has been persisted in the queue. It will + // remain in this state until there are sufficient free resources to + // begin provisioning your request. Wait times will vary significantly + // depending on demand levels. When demand is high, not all requests can + // be immediately provisioned. If you need more reliable obtainability + // of TPUs consider purchasing a reservation. To put a limit on how long + // you are willing to wait, use [timing + // constraints](https://cloud.google.com/tpu/docs/queued-resources#reques + // t_a_queued_resource_before_a_specified_time). State string `json:"state,omitempty"` // StateInitiator: Output only. The initiator of the QueuedResources's diff --git a/workloadmanager/v1/workloadmanager-api.json b/workloadmanager/v1/workloadmanager-api.json index 647bb062de6..f8c3de0d093 100644 --- a/workloadmanager/v1/workloadmanager-api.json +++ b/workloadmanager/v1/workloadmanager-api.json @@ -707,7 +707,7 @@ } } }, - "revision": "20230719", + "revision": "20230907", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -915,11 +915,11 @@ }, "sapDiscovery": { "$ref": "SapDiscovery", - "description": "The insights data for sap system discovery. This is a copy of SAP System proto and should get updated whenever that one changes." + "description": "The insights data for SAP system discovery. This is a copy of SAP System proto and should get updated whenever that one changes." }, "sapValidation": { "$ref": "SapValidation", - "description": "The insights data for the sap workload validation." + "description": "The insights data for the SAP workload validation." }, "sentTime": { "description": "Output only. [Output only] Create time stamp", @@ -1137,7 +1137,7 @@ "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, - "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object" } }, @@ -1337,27 +1337,28 @@ "type": "object" }, "SapDiscovery": { - "description": "LINT.IfChange The schema of SAP system discovery data.", + "description": "The schema of SAP system discovery data.", "id": "SapDiscovery", "properties": { "applicationLayer": { "$ref": "SapDiscoveryComponent", - "description": "An SAP system may run without an application layer." + "description": "Optional. An SAP system may run without an application layer." }, "databaseLayer": { "$ref": "SapDiscoveryComponent", - "description": "An SAP System must have a database." + "description": "Required. An SAP System must have a database." }, "metadata": { "$ref": "SapDiscoveryMetadata", - "description": "The metadata for SAP system discovery data." + "description": "Optional. The metadata for SAP system discovery data." }, "systemId": { - "description": "A combination of database SID, database instance URI and tenant DB name to make a unique identifier per-system.", + "description": "Output only. A combination of database SID, database instance URI and tenant DB name to make a unique identifier per-system.", + "readOnly": true, "type": "string" }, "updateTime": { - "description": "Unix timestamp this system has been updated last.", + "description": "Required. Unix timestamp this system has been updated last.", "format": "google-datetime", "type": "string" } @@ -1377,18 +1378,18 @@ "description": "Optional. The component is a SAP database." }, "hostProject": { - "description": "Pantheon Project in which the resources reside.", + "description": "Required. Pantheon Project in which the resources reside.", "type": "string" }, "resources": { - "description": "The resources in a component.", + "description": "Optional. The resources in a component.", "items": { "$ref": "SapDiscoveryResource" }, "type": "array" }, "sid": { - "description": "The sap identifier, used by the SAP software and helps differentiate systems for customers.", + "description": "Optional. The SAP identifier, used by the SAP software and helps differentiate systems for customers.", "type": "string" } }, @@ -1411,7 +1412,7 @@ "type": "string" }, "ascsUri": { - "description": "Required. Resource URI of the recognized ASCS host of the application.", + "description": "Optional. Resource URI of the recognized ASCS host of the application.", "type": "string" }, "nfsUri": { @@ -1457,19 +1458,19 @@ "id": "SapDiscoveryMetadata", "properties": { "customerRegion": { - "description": "Customer region string for customer's use. Does not represent GCP region.", + "description": "Optional. Customer region string for customer's use. Does not represent GCP region.", "type": "string" }, "definedSystem": { - "description": "Customer defined, something like \"E-commerce pre prod\"", + "description": "Optional. Customer defined, something like \"E-commerce pre prod\"", "type": "string" }, "environmentType": { - "description": "Should be \"prod\", \"QA\", \"dev\", \"staging\", etc.", + "description": "Optional. Should be \"prod\", \"QA\", \"dev\", \"staging\", etc.", "type": "string" }, "sapProduct": { - "description": "This sap product name", + "description": "Optional. This SAP product name", "type": "string" } }, @@ -1480,7 +1481,7 @@ "id": "SapDiscoveryResource", "properties": { "relatedResources": { - "description": "A list of resource URIs related to this resource.", + "description": "Optional. A list of resource URIs related to this resource.", "items": { "type": "string" }, @@ -1535,11 +1536,11 @@ "type": "string" }, "resourceUri": { - "description": "URI of the resource, includes project, location, and name.", + "description": "Required. URI of the resource, includes project, location, and name.", "type": "string" }, "updateTime": { - "description": "Unix timestamp of when this resource last had its discovery data updated.", + "description": "Required. Unix timestamp of when this resource last had its discovery data updated.", "format": "google-datetime", "type": "string" } @@ -1551,7 +1552,7 @@ "id": "SapValidation", "properties": { "validationDetails": { - "description": "A list of SAP validation metrics data.", + "description": "Optional. A list of SAP validation metrics data.", "items": { "$ref": "SapValidationValidationDetail" }, @@ -1568,26 +1569,30 @@ "additionalProperties": { "type": "string" }, - "description": "The pairs of metrics data: field name \u0026 field value.", + "description": "Optional. The pairs of metrics data: field name \u0026 field value.", "type": "object" }, "sapValidationType": { - "description": "The SAP system that the validation data is from.", + "description": "Optional. The SAP system that the validation data is from.", "enum": [ "SAP_VALIDATION_TYPE_UNSPECIFIED", "SYSTEM", "COROSYNC", "PACEMAKER", "HANA", - "NETWEAVER" + "NETWEAVER", + "HANA_SECURITY", + "CUSTOM" ], "enumDescriptions": [ "Unspecified type.", - "The SAP system named SYSTEM.", - "The SAP system named COROSYNC.", - "The SAP system named PACEMAKER.", - "The SAP system named HANA.", - "The SAP system named NETWEAVER." + "The SYSTEM validation type collects underlying system data from the VM.", + "The COROSYNC validation type collects Corosync configuration and runtime data. Corosync enables servers to interact as a HA cluster.", + "The PACEMAKER validation type collects Pacemaker configuration data. Pacemaker is a high-availability cluster resource manager.", + "The HANA validation type collects HANA configuration data. SAP HANA is an in-memory, column-oriented, relational database management system.", + "The NETWEAVER validation type collects NetWeaver configuration data. SAP NetWeaver is a software stack for many of SAP SE's applications.", + "The HANA_SECURITY validation type collects HANA configuration data as it relates to SAP security best practices.", + "The CUSTOM validation type collects any customer-defined data that does not fall into any of the other categories of validations." ], "type": "string" } @@ -1610,7 +1615,7 @@ "id": "SqlserverValidation", "properties": { "agentVersion": { - "description": "The agent version collected this data point", + "description": "Optional. The agent version collected this data point", "type": "string" }, "instance": { @@ -1622,7 +1627,7 @@ "type": "string" }, "validationDetails": { - "description": "A list of SqlServer validation metrics data.", + "description": "Optional. A list of SqlServer validation metrics data.", "items": { "$ref": "SqlserverValidationValidationDetail" }, @@ -1657,7 +1662,7 @@ "type": "array" }, "type": { - "description": "The Sqlserver system that the validation data is from.", + "description": "Optional. The Sqlserver system that the validation data is from.", "enum": [ "SQLSERVER_VALIDATION_TYPE_UNSPECIFIED", "OS", @@ -1668,7 +1673,10 @@ "DB_VIRTUAL_LOG_FILE_COUNT", "DB_BUFFER_POOL_EXTENSION", "DB_MAX_SERVER_MEMORY", - "INSTANCE_METRICS" + "INSTANCE_METRICS", + "DB_INDEX_FRAGMENTATION", + "DB_TABLE_INDEX_COMPRESSION", + "DB_BACKUP_POLICY" ], "enumDescriptions": [ "Unspecified type.", @@ -1680,7 +1688,10 @@ "The VIRTUAL_LOG_FILE_COUNT table.", "The BUFFER_POOL_EXTENSION table.", "The MAX_SERVER_MEMORY table.", - "The INSTANCE_METRICS table." + "The INSTANCE_METRICS table.", + "The DB_INDEX_FRAGMENTATION table.", + "The DB_TABLE_INDEX_COMPRESSION table.", + "The DB_BACKUP_POLICY table." ], "type": "string" } diff --git a/workloadmanager/v1/workloadmanager-gen.go b/workloadmanager/v1/workloadmanager-gen.go index 8529afea9f0..ad353a1db60 100644 --- a/workloadmanager/v1/workloadmanager-gen.go +++ b/workloadmanager/v1/workloadmanager-gen.go @@ -487,12 +487,12 @@ type Insight struct { // from InstanceId string `json:"instanceId,omitempty"` - // SapDiscovery: The insights data for sap system discovery. This is a + // SapDiscovery: The insights data for SAP system discovery. This is a // copy of SAP System proto and should get updated whenever that one // changes. SapDiscovery *SapDiscovery `json:"sapDiscovery,omitempty"` - // SapValidation: The insights data for the sap workload validation. + // SapValidation: The insights data for the SAP workload validation. SapValidation *SapValidation `json:"sapValidation,omitempty"` // SentTime: Output only. [Output only] Create time stamp @@ -865,8 +865,8 @@ type Operation struct { // `operations/{unique_id}`. Name string `json:"name,omitempty"` - // Response: The normal response of the operation in case of success. If - // the original method returns no data on success, such as `Delete`, the + // Response: The normal, successful response of the operation. If the + // original method returns no data on success, such as `Delete`, the // response is `google.protobuf.Empty`. If the original method is // standard `Get`/`Create`/`Update`, the response should be the // resource. For other methods, the response should have the type @@ -1169,22 +1169,25 @@ func (s *RunEvaluationRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// SapDiscovery: LINT.IfChange The schema of SAP system discovery data. +// SapDiscovery: The schema of SAP system discovery data. type SapDiscovery struct { - // ApplicationLayer: An SAP system may run without an application layer. + // ApplicationLayer: Optional. An SAP system may run without an + // application layer. ApplicationLayer *SapDiscoveryComponent `json:"applicationLayer,omitempty"` - // DatabaseLayer: An SAP System must have a database. + // DatabaseLayer: Required. An SAP System must have a database. DatabaseLayer *SapDiscoveryComponent `json:"databaseLayer,omitempty"` - // Metadata: The metadata for SAP system discovery data. + // Metadata: Optional. The metadata for SAP system discovery data. Metadata *SapDiscoveryMetadata `json:"metadata,omitempty"` - // SystemId: A combination of database SID, database instance URI and - // tenant DB name to make a unique identifier per-system. + // SystemId: Output only. A combination of database SID, database + // instance URI and tenant DB name to make a unique identifier + // per-system. SystemId string `json:"systemId,omitempty"` - // UpdateTime: Unix timestamp this system has been updated last. + // UpdateTime: Required. Unix timestamp this system has been updated + // last. UpdateTime string `json:"updateTime,omitempty"` // ForceSendFields is a list of field names (e.g. "ApplicationLayer") to @@ -1219,13 +1222,14 @@ type SapDiscoveryComponent struct { // DatabaseProperties: Optional. The component is a SAP database. DatabaseProperties *SapDiscoveryComponentDatabaseProperties `json:"databaseProperties,omitempty"` - // HostProject: Pantheon Project in which the resources reside. + // HostProject: Required. Pantheon Project in which the resources + // reside. HostProject string `json:"hostProject,omitempty"` - // Resources: The resources in a component. + // Resources: Optional. The resources in a component. Resources []*SapDiscoveryResource `json:"resources,omitempty"` - // Sid: The sap identifier, used by the SAP software and helps + // Sid: Optional. The SAP identifier, used by the SAP software and helps // differentiate systems for customers. Sid string `json:"sid,omitempty"` @@ -1264,7 +1268,7 @@ type SapDiscoveryComponentApplicationProperties struct { // "NETWEAVER" - SAP Netweaver ApplicationType string `json:"applicationType,omitempty"` - // AscsUri: Required. Resource URI of the recognized ASCS host of the + // AscsUri: Optional. Resource URI of the recognized ASCS host of the // application. AscsUri string `json:"ascsUri,omitempty"` @@ -1343,17 +1347,19 @@ func (s *SapDiscoveryComponentDatabaseProperties) MarshalJSON() ([]byte, error) // SapDiscoveryMetadata: Message describing SAP discovery system // metadata type SapDiscoveryMetadata struct { - // CustomerRegion: Customer region string for customer's use. Does not - // represent GCP region. + // CustomerRegion: Optional. Customer region string for customer's use. + // Does not represent GCP region. CustomerRegion string `json:"customerRegion,omitempty"` - // DefinedSystem: Customer defined, something like "E-commerce pre prod" + // DefinedSystem: Optional. Customer defined, something like "E-commerce + // pre prod" DefinedSystem string `json:"definedSystem,omitempty"` - // EnvironmentType: Should be "prod", "QA", "dev", "staging", etc. + // EnvironmentType: Optional. Should be "prod", "QA", "dev", "staging", + // etc. EnvironmentType string `json:"environmentType,omitempty"` - // SapProduct: This sap product name + // SapProduct: Optional. This SAP product name SapProduct string `json:"sapProduct,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomerRegion") to @@ -1382,7 +1388,8 @@ func (s *SapDiscoveryMetadata) MarshalJSON() ([]byte, error) { // SapDiscoveryResource: Message describing a resource. type SapDiscoveryResource struct { - // RelatedResources: A list of resource URIs related to this resource. + // RelatedResources: Optional. A list of resource URIs related to this + // resource. RelatedResources []string `json:"relatedResources,omitempty"` // ResourceKind: Required. ComputeInstance, ComputeDisk, VPC, Bare Metal @@ -1415,12 +1422,12 @@ type SapDiscoveryResource struct { // "RESOURCE_TYPE_NETWORK" - This is a network resource. ResourceType string `json:"resourceType,omitempty"` - // ResourceUri: URI of the resource, includes project, location, and - // name. + // ResourceUri: Required. URI of the resource, includes project, + // location, and name. ResourceUri string `json:"resourceUri,omitempty"` - // UpdateTime: Unix timestamp of when this resource last had its - // discovery data updated. + // UpdateTime: Required. Unix timestamp of when this resource last had + // its discovery data updated. UpdateTime string `json:"updateTime,omitempty"` // ForceSendFields is a list of field names (e.g. "RelatedResources") to @@ -1450,7 +1457,7 @@ func (s *SapDiscoveryResource) MarshalJSON() ([]byte, error) { // SapValidation: A presentation of SAP workload insight. The schema of // SAP workloads validation related data. type SapValidation struct { - // ValidationDetails: A list of SAP validation metrics data. + // ValidationDetails: Optional. A list of SAP validation metrics data. ValidationDetails []*SapValidationValidationDetail `json:"validationDetails,omitempty"` // ForceSendFields is a list of field names (e.g. "ValidationDetails") @@ -1480,18 +1487,34 @@ func (s *SapValidation) MarshalJSON() ([]byte, error) { // SapValidationValidationDetail: Message describing the SAP validation // metrics. type SapValidationValidationDetail struct { - // Details: The pairs of metrics data: field name & field value. + // Details: Optional. The pairs of metrics data: field name & field + // value. Details map[string]string `json:"details,omitempty"` - // SapValidationType: The SAP system that the validation data is from. + // SapValidationType: Optional. The SAP system that the validation data + // is from. // // Possible values: // "SAP_VALIDATION_TYPE_UNSPECIFIED" - Unspecified type. - // "SYSTEM" - The SAP system named SYSTEM. - // "COROSYNC" - The SAP system named COROSYNC. - // "PACEMAKER" - The SAP system named PACEMAKER. - // "HANA" - The SAP system named HANA. - // "NETWEAVER" - The SAP system named NETWEAVER. + // "SYSTEM" - The SYSTEM validation type collects underlying system + // data from the VM. + // "COROSYNC" - The COROSYNC validation type collects Corosync + // configuration and runtime data. Corosync enables servers to interact + // as a HA cluster. + // "PACEMAKER" - The PACEMAKER validation type collects Pacemaker + // configuration data. Pacemaker is a high-availability cluster resource + // manager. + // "HANA" - The HANA validation type collects HANA configuration data. + // SAP HANA is an in-memory, column-oriented, relational database + // management system. + // "NETWEAVER" - The NETWEAVER validation type collects NetWeaver + // configuration data. SAP NetWeaver is a software stack for many of SAP + // SE's applications. + // "HANA_SECURITY" - The HANA_SECURITY validation type collects HANA + // configuration data as it relates to SAP security best practices. + // "CUSTOM" - The CUSTOM validation type collects any customer-defined + // data that does not fall into any of the other categories of + // validations. SapValidationType string `json:"sapValidationType,omitempty"` // ForceSendFields is a list of field names (e.g. "Details") to @@ -1548,7 +1571,7 @@ func (s *ScannedResource) MarshalJSON() ([]byte, error) { // SqlserverValidation: A presentation of SQLServer workload insight. // The schema of SqlServer workloads validation related data. type SqlserverValidation struct { - // AgentVersion: The agent version collected this data point + // AgentVersion: Optional. The agent version collected this data point AgentVersion string `json:"agentVersion,omitempty"` // Instance: Required. The instance_name of the instance that the @@ -1561,7 +1584,8 @@ type SqlserverValidation struct { // Insight data comes from. ProjectId string `json:"projectId,omitempty"` - // ValidationDetails: A list of SqlServer validation metrics data. + // ValidationDetails: Optional. A list of SqlServer validation metrics + // data. ValidationDetails []*SqlserverValidationValidationDetail `json:"validationDetails,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentVersion") to @@ -1623,7 +1647,8 @@ type SqlserverValidationValidationDetail struct { // names and values. Details []*SqlserverValidationDetails `json:"details,omitempty"` - // Type: The Sqlserver system that the validation data is from. + // Type: Optional. The Sqlserver system that the validation data is + // from. // // Possible values: // "SQLSERVER_VALIDATION_TYPE_UNSPECIFIED" - Unspecified type. @@ -1636,6 +1661,10 @@ type SqlserverValidationValidationDetail struct { // "DB_BUFFER_POOL_EXTENSION" - The BUFFER_POOL_EXTENSION table. // "DB_MAX_SERVER_MEMORY" - The MAX_SERVER_MEMORY table. // "INSTANCE_METRICS" - The INSTANCE_METRICS table. + // "DB_INDEX_FRAGMENTATION" - The DB_INDEX_FRAGMENTATION table. + // "DB_TABLE_INDEX_COMPRESSION" - The DB_TABLE_INDEX_COMPRESSION + // table. + // "DB_BACKUP_POLICY" - The DB_BACKUP_POLICY table. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Details") to