diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index c3f5587a65a..024e5417621 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20240124", + "revision": "20240131", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -2232,7 +2232,7 @@ "No result was specified.", "Possible scenarios are: * The configuration analysis determined that a packet originating from the source is expected to reach the destination. * The analysis didn't complete because the user lacks permission for some of the resources in the trace. However, at the time the user's permission became insufficient, the trace had been successful so far.", "A packet originating from the source is expected to be dropped before reaching the destination.", - "The source and destination endpoints do not uniquely identify the test location in the network, and the reachability result contains multiple traces. For some traces, a packet could be delivered, and for others, it would not be.", + "The source and destination endpoints do not uniquely identify the test location in the network, and the reachability result contains multiple traces. For some traces, a packet could be delivered, and for others, it would not be. This result is also assigned to configuration analysis of return path if on its own it should be REACHABLE, but configuration analysis of forward path is AMBIGUOUS.", "The configuration analysis did not complete. Possible reasons are: * A permissions error occurred--for example, the user might not have read permission for all of the resources named in the test. * An internal error occurred. * The analyzer received an invalid or unsupported argument or was unable to identify a known endpoint." ], "type": "string" @@ -2711,6 +2711,11 @@ "$ref": "EndpointInfo", "description": "Derived from the source and destination endpoints definition specified by user request, and validated by the data plane model. If there are multiple traces starting from different source locations, then the endpoint_info may be different between traces." }, + "forwardTraceId": { + "description": "ID of trace. For forward traces, this ID is unique for each trace. For return traces, it matches ID of associated forward trace. A single forward trace can be associated with none, one or more than one return trace.", + "format": "int32", + "type": "integer" + }, "steps": { "description": "A trace of a test contains multiple steps from the initial state to the final state (delivered, dropped, forwarded, or aborted). The steps are ordered by the processing sequence within the simulated network state machine. It is critical to preserve the order of the steps and avoid reordering or sorting them.", "items": { diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index 92e8cdc1841..73ab13efca5 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -2689,7 +2689,10 @@ type ReachabilityDetails struct { // "AMBIGUOUS" - The source and destination endpoints do not uniquely // identify the test location in the network, and the reachability // result contains multiple traces. For some traces, a packet could be - // delivered, and for others, it would not be. + // delivered, and for others, it would not be. This result is also + // assigned to configuration analysis of return path if on its own it + // should be REACHABLE, but configuration analysis of forward path is + // AMBIGUOUS. // "UNDETERMINED" - The configuration analysis did not complete. // Possible reasons are: * A permissions error occurred--for example, // the user might not have read permission for all of the resources @@ -3235,6 +3238,12 @@ type Trace struct { // locations, then the endpoint_info may be different between traces. EndpointInfo *EndpointInfo `json:"endpointInfo,omitempty"` + // ForwardTraceId: ID of trace. For forward traces, this ID is unique + // for each trace. For return traces, it matches ID of associated + // forward trace. A single forward trace can be associated with none, + // one or more than one return trace. + ForwardTraceId int64 `json:"forwardTraceId,omitempty"` + // Steps: A trace of a test contains multiple steps from the initial // state to the final state (delivered, dropped, forwarded, or aborted). // The steps are ordered by the processing sequence within the simulated diff --git a/networkmanagement/v1beta1/networkmanagement-api.json b/networkmanagement/v1beta1/networkmanagement-api.json index 4f561893213..9172f2204af 100644 --- a/networkmanagement/v1beta1/networkmanagement-api.json +++ b/networkmanagement/v1beta1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20240124", + "revision": "20240131", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -2237,7 +2237,7 @@ "No result was specified.", "Possible scenarios are: * The configuration analysis determined that a packet originating from the source is expected to reach the destination. * The analysis didn't complete because the user lacks permission for some of the resources in the trace. However, at the time the user's permission became insufficient, the trace had been successful so far.", "A packet originating from the source is expected to be dropped before reaching the destination.", - "The source and destination endpoints do not uniquely identify the test location in the network, and the reachability result contains multiple traces. For some traces, a packet could be delivered, and for others, it would not be.", + "The source and destination endpoints do not uniquely identify the test location in the network, and the reachability result contains multiple traces. For some traces, a packet could be delivered, and for others, it would not be. This result is also assigned to configuration analysis of return path if on its own it should be REACHABLE, but configuration analysis of forward path is AMBIGUOUS.", "The configuration analysis did not complete. Possible reasons are: * A permissions error occurred--for example, the user might not have read permission for all of the resources named in the test. * An internal error occurred. * The analyzer received an invalid or unsupported argument or was unable to identify a known endpoint." ], "type": "string" @@ -2716,6 +2716,11 @@ "$ref": "EndpointInfo", "description": "Derived from the source and destination endpoints definition specified by user request, and validated by the data plane model. If there are multiple traces starting from different source locations, then the endpoint_info may be different between traces." }, + "forwardTraceId": { + "description": "ID of trace. For forward traces, this ID is unique for each trace. For return traces, it matches ID of associated forward trace. A single forward trace can be associated with none, one or more than one return trace.", + "format": "int32", + "type": "integer" + }, "steps": { "description": "A trace of a test contains multiple steps from the initial state to the final state (delivered, dropped, forwarded, or aborted). The steps are ordered by the processing sequence within the simulated network state machine. It is critical to preserve the order of the steps and avoid reordering or sorting them.", "items": { diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index 54d1f968725..fbfc0c9f2c5 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -2692,7 +2692,10 @@ type ReachabilityDetails struct { // "AMBIGUOUS" - The source and destination endpoints do not uniquely // identify the test location in the network, and the reachability // result contains multiple traces. For some traces, a packet could be - // delivered, and for others, it would not be. + // delivered, and for others, it would not be. This result is also + // assigned to configuration analysis of return path if on its own it + // should be REACHABLE, but configuration analysis of forward path is + // AMBIGUOUS. // "UNDETERMINED" - The configuration analysis did not complete. // Possible reasons are: * A permissions error occurred--for example, // the user might not have read permission for all of the resources @@ -3240,6 +3243,12 @@ type Trace struct { // locations, then the endpoint_info may be different between traces. EndpointInfo *EndpointInfo `json:"endpointInfo,omitempty"` + // ForwardTraceId: ID of trace. For forward traces, this ID is unique + // for each trace. For return traces, it matches ID of associated + // forward trace. A single forward trace can be associated with none, + // one or more than one return trace. + ForwardTraceId int64 `json:"forwardTraceId,omitempty"` + // Steps: A trace of a test contains multiple steps from the initial // state to the final state (delivered, dropped, forwarded, or aborted). // The steps are ordered by the processing sequence within the simulated diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index afd53b9c026..7743887a5c7 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -2729,7 +2729,7 @@ } } }, - "revision": "20240131", + "revision": "20240207", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "AutoscalingConfig": { @@ -3285,7 +3285,7 @@ "type": "array" }, "protoDescriptors": { - "description": "Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements in 'extra_statements' above. Contains a protobuf-serialized [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run \"\"\" $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto \"\"\" For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).", + "description": "Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements in 'extra_statements' above. Contains a protobuf-serialized [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run ``` $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto ``` For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).", "format": "byte", "type": "string" } @@ -3345,6 +3345,20 @@ "format": "google-datetime", "type": "string" }, + "expectedFulfillmentPeriod": { + "description": "The expected fulfillment period of this create operation.", + "enum": [ + "FULFILLMENT_PERIOD_UNSPECIFIED", + "FULFILLMENT_PERIOD_NORMAL", + "FULFILLMENT_PERIOD_EXTENDED" + ], + "enumDescriptions": [ + "Not specified.", + "Normal fulfillment period. The operation is expected to complete within minutes.", + "Extended fulfillment period. It can take up to an hour for the operation to complete." + ], + "type": "string" + }, "instance": { "$ref": "Instance", "description": "The instance being created." @@ -3585,7 +3599,7 @@ "properties": { "excludeReplicas": { "$ref": "ExcludeReplicas", - "description": "Exclude_replicas indicates that should be excluded from serving requests. Spanner will not route requests to the replicas in this list." + "description": "Exclude_replicas indicates that specified replicas should be excluded from serving requests. Spanner will not route requests to the replicas in this list." }, "includeReplicas": { "$ref": "IncludeReplicas", @@ -5210,7 +5224,7 @@ "type": "object" }, "ReplicaSelection": { - "description": "The directed read replica selector. Callers must provide one or more of the following fields for replica selection: * `location` - The location must be one of the regions within the multi-region configuration of your database. * `type` - The type of the replica. Some examples of using replica_selectors are: * `location:us-east1` --\u003e The \"us-east1\" replica(s) of any available type will be used to process the request. * `type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in nearest . available location will be used to process the request. * `location:us-east1 type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in location \"us-east1\" will be used to process the request.", + "description": "The directed read replica selector. Callers must provide one or more of the following fields for replica selection: * `location` - The location must be one of the regions within the multi-region configuration of your database. * `type` - The type of the replica. Some examples of using replica_selectors are: * `location:us-east1` --\u003e The \"us-east1\" replica(s) of any available type will be used to process the request. * `type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in nearest available location will be used to process the request. * `location:us-east1 type:READ_ONLY` --\u003e The \"READ_ONLY\" type replica(s) in location \"us-east1\" will be used to process the request.", "id": "ReplicaSelection", "properties": { "location": { @@ -5855,7 +5869,7 @@ "type": "string" }, "protoDescriptors": { - "description": "Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements. Contains a protobuf-serialized [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run \"\"\" $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto \"\"\" For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).", + "description": "Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements. Contains a protobuf-serialized [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run ``` $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto ``` For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).", "format": "byte", "type": "string" }, @@ -5959,6 +5973,20 @@ "format": "google-datetime", "type": "string" }, + "expectedFulfillmentPeriod": { + "description": "The expected fulfillment period of this update operation.", + "enum": [ + "FULFILLMENT_PERIOD_UNSPECIFIED", + "FULFILLMENT_PERIOD_NORMAL", + "FULFILLMENT_PERIOD_EXTENDED" + ], + "enumDescriptions": [ + "Not specified.", + "Normal fulfillment period. The operation is expected to complete within minutes.", + "Extended fulfillment period. It can take up to an hour for the operation to complete." + ], + "type": "string" + }, "instance": { "$ref": "Instance", "description": "The desired end state of the update." diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index f60cba60a75..7f742613739 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -1451,9 +1451,9 @@ type CreateDatabaseRequest struct { // (https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). // To generate it, install (https://grpc.io/docs/protoc-installation/) // and run `protoc` with --include_imports and --descriptor_set_out. For - // example, to generate for moon/shot/app.proto, run """ $protoc + // example, to generate for moon/shot/app.proto, run ``` $protoc // --proto_path=/app_path --proto_path=/lib_path \ --include_imports \ - // --descriptor_set_out=descriptors.data \ moon/shot/app.proto """ For + // --descriptor_set_out=descriptors.data \ moon/shot/app.proto ``` For // more details, see protobuffer self description // (https://developers.google.com/protocol-buffers/docs/techniques#self-description). ProtoDescriptors string `json:"protoDescriptors,omitempty"` @@ -1574,6 +1574,17 @@ type CreateInstanceMetadata struct { // successfully. EndTime string `json:"endTime,omitempty"` + // ExpectedFulfillmentPeriod: The expected fulfillment period of this + // create operation. + // + // Possible values: + // "FULFILLMENT_PERIOD_UNSPECIFIED" - Not specified. + // "FULFILLMENT_PERIOD_NORMAL" - Normal fulfillment period. The + // operation is expected to complete within minutes. + // "FULFILLMENT_PERIOD_EXTENDED" - Extended fulfillment period. It can + // take up to an hour for the operation to complete. + ExpectedFulfillmentPeriod string `json:"expectedFulfillmentPeriod,omitempty"` + // Instance: The instance being created. Instance *Instance `json:"instance,omitempty"` @@ -1979,9 +1990,9 @@ func (s *DiagnosticMessage) MarshalJSON() ([]byte, error) { // transaction, otherwise the API will return an `INVALID_ARGUMENT` // error. type DirectedReadOptions struct { - // ExcludeReplicas: Exclude_replicas indicates that should be excluded - // from serving requests. Spanner will not route requests to the - // replicas in this list. + // ExcludeReplicas: Exclude_replicas indicates that specified replicas + // should be excluded from serving requests. Spanner will not route + // requests to the replicas in this list. ExcludeReplicas *ExcludeReplicas `json:"excludeReplicas,omitempty"` // IncludeReplicas: Include_replicas indicates the order of replicas (as @@ -5086,7 +5097,7 @@ func (s *ReplicaInfo) MarshalJSON() ([]byte, error) { // the replica. Some examples of using replica_selectors are: * // `location:us-east1` --> The "us-east1" replica(s) of any available // type will be used to process the request. * `type:READ_ONLY` --> The -// "READ_ONLY" type replica(s) in nearest . available location will be +// "READ_ONLY" type replica(s) in nearest available location will be // used to process the request. * `location:us-east1 type:READ_ONLY` --> // The "READ_ONLY" type replica(s) in location "us-east1" will be used // to process the request. @@ -6474,9 +6485,9 @@ type UpdateDatabaseDdlRequest struct { // (https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). // To generate it, install (https://grpc.io/docs/protoc-installation/) // and run `protoc` with --include_imports and --descriptor_set_out. For - // example, to generate for moon/shot/app.proto, run """ $protoc + // example, to generate for moon/shot/app.proto, run ``` $protoc // --proto_path=/app_path --proto_path=/lib_path \ --include_imports \ - // --descriptor_set_out=descriptors.data \ moon/shot/app.proto """ For + // --descriptor_set_out=descriptors.data \ moon/shot/app.proto ``` For // more details, see protobuffer self description // (https://developers.google.com/protocol-buffers/docs/techniques#self-description). ProtoDescriptors string `json:"protoDescriptors,omitempty"` @@ -6668,6 +6679,17 @@ type UpdateInstanceMetadata struct { // successfully. EndTime string `json:"endTime,omitempty"` + // ExpectedFulfillmentPeriod: The expected fulfillment period of this + // update operation. + // + // Possible values: + // "FULFILLMENT_PERIOD_UNSPECIFIED" - Not specified. + // "FULFILLMENT_PERIOD_NORMAL" - Normal fulfillment period. The + // operation is expected to complete within minutes. + // "FULFILLMENT_PERIOD_EXTENDED" - Extended fulfillment period. It can + // take up to an hour for the operation to complete. + ExpectedFulfillmentPeriod string `json:"expectedFulfillmentPeriod,omitempty"` + // Instance: The desired end state of the update. Instance *Instance `json:"instance,omitempty"`