|
652 | 652 | "scopes": [
|
653 | 653 | "https://www.googleapis.com/auth/cloud-platform"
|
654 | 654 | ]
|
| 655 | + }, |
| 656 | + "computeTimeCursor": { |
| 657 | + "description": "Compute the corresponding cursor for a publish or event time in a topic partition.", |
| 658 | + "flatPath": "v1/topicStats/projects/{projectsId}/locations/{locationsId}/topics/{topicsId}:computeTimeCursor", |
| 659 | + "httpMethod": "POST", |
| 660 | + "id": "pubsublite.topicStats.projects.locations.topics.computeTimeCursor", |
| 661 | + "parameterOrder": [ |
| 662 | + "topic" |
| 663 | + ], |
| 664 | + "parameters": { |
| 665 | + "topic": { |
| 666 | + "description": "Required. The topic for which we should compute the cursor.", |
| 667 | + "location": "path", |
| 668 | + "pattern": "^projects/[^/]+/locations/[^/]+/topics/[^/]+$", |
| 669 | + "required": true, |
| 670 | + "type": "string" |
| 671 | + } |
| 672 | + }, |
| 673 | + "path": "v1/topicStats/{+topic}:computeTimeCursor", |
| 674 | + "request": { |
| 675 | + "$ref": "ComputeTimeCursorRequest" |
| 676 | + }, |
| 677 | + "response": { |
| 678 | + "$ref": "ComputeTimeCursorResponse" |
| 679 | + }, |
| 680 | + "scopes": [ |
| 681 | + "https://www.googleapis.com/auth/cloud-platform" |
| 682 | + ] |
655 | 683 | }
|
656 | 684 | }
|
657 | 685 | }
|
|
662 | 690 | }
|
663 | 691 | }
|
664 | 692 | },
|
665 |
| - "revision": "20210504", |
| 693 | + "revision": "20210513", |
666 | 694 | "rootUrl": "https://pubsublite.googleapis.com/",
|
667 | 695 | "schemas": {
|
668 | 696 | "Capacity": {
|
|
774 | 802 | },
|
775 | 803 | "type": "object"
|
776 | 804 | },
|
| 805 | + "ComputeTimeCursorRequest": { |
| 806 | + "description": "Compute the corresponding cursor for a publish or event time in a topic partition.", |
| 807 | + "id": "ComputeTimeCursorRequest", |
| 808 | + "properties": { |
| 809 | + "partition": { |
| 810 | + "description": "Required. The partition for which we should compute the cursor.", |
| 811 | + "format": "int64", |
| 812 | + "type": "string" |
| 813 | + }, |
| 814 | + "target": { |
| 815 | + "$ref": "TimeTarget", |
| 816 | + "description": "Required. The target publish or event time. Specifying a future time will return an unset cursor." |
| 817 | + } |
| 818 | + }, |
| 819 | + "type": "object" |
| 820 | + }, |
| 821 | + "ComputeTimeCursorResponse": { |
| 822 | + "description": "Response containing the cursor corresponding to a publish or event time in a topic partition.", |
| 823 | + "id": "ComputeTimeCursorResponse", |
| 824 | + "properties": { |
| 825 | + "cursor": { |
| 826 | + "$ref": "Cursor", |
| 827 | + "description": "If present, the cursor references the first message with time greater than or equal to the specified target time. If such a message cannot be found, the cursor will be unset (i.e. `cursor` is not present)." |
| 828 | + } |
| 829 | + }, |
| 830 | + "type": "object" |
| 831 | + }, |
777 | 832 | "Cursor": {
|
778 | 833 | "description": "A cursor that describes the position of a message within a topic partition.",
|
779 | 834 | "id": "Cursor",
|
|
958 | 1013 | },
|
959 | 1014 | "type": "object"
|
960 | 1015 | },
|
| 1016 | + "TimeTarget": { |
| 1017 | + "description": "A target publish or event time. Can be used for seeking to or retrieving the corresponding cursor.", |
| 1018 | + "id": "TimeTarget", |
| 1019 | + "properties": { |
| 1020 | + "eventTime": { |
| 1021 | + "description": "Request the cursor of the first message with event time greater than or equal to `event_time`. If messages are missing an event time, the publish time is used as a fallback. As event times are user supplied, subsequent messages may have event times less than `event_time` and should be filtered by the client, if necessary.", |
| 1022 | + "format": "google-datetime", |
| 1023 | + "type": "string" |
| 1024 | + }, |
| 1025 | + "publishTime": { |
| 1026 | + "description": "Request the cursor of the first message with publish time greater than or equal to `publish_time`. All messages thereafter are guaranteed to have publish times >= `publish_time`.", |
| 1027 | + "format": "google-datetime", |
| 1028 | + "type": "string" |
| 1029 | + } |
| 1030 | + }, |
| 1031 | + "type": "object" |
| 1032 | + }, |
961 | 1033 | "Topic": {
|
962 | 1034 | "description": "Metadata about a topic resource.",
|
963 | 1035 | "id": "Topic",
|
|
0 commit comments