google-cloud-pubsub-v1 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 270357a559d9e1344abcde2b48faf62a898b5fd93e5c9034f861989f2e5fc527
4
- data.tar.gz: a90a3bbceb9374522eb61da746f76b423b967d07a978b88a68b48fb69cb02ca3
3
+ metadata.gz: e1289905e3038a6dfc4bee5998f010e7a1d9dd575ec00b510e1e62683a47d068
4
+ data.tar.gz: 7d68937c1da40e5229483bfddfdc863c6f53eea3668490430b02bf731f29ce8e
5
5
  SHA512:
6
- metadata.gz: 64c9d2969334548363f2f0846adb94c00a3e6d721a8e7fcad7b3e5ea518dbf073718677ca96b1b77ca48551b7cbb46060314c6622eb8051264a3fb339510f5c8
7
- data.tar.gz: 3615b3aa3a230e7ec72e1a8aa015b1538b213c7a3dfe4ba3fc07ffec0570d1fcbc6f999685fd1b1b9e59fdffdcba2323b4d25abc0acad4e8edcf72cc00952c3b
6
+ metadata.gz: 8c4d7f7ed6d5c94be0334734d7b202e912e53dce9e1b508295fd9fcb3713de575e36e17b4305ce007219067a0e18a3561f753d2778750d0348cbc808020a5fca
7
+ data.tar.gz: d440f8b43e2ca2db19723026a72f67baf42fb2ae4ba4b54a54863f09c546bd28a3a62b4adba31612365390456c9bd2d54092d6a63a74b61a88e225fed0478e69
@@ -71,7 +71,7 @@ module Google
71
71
  initial_delay: 0.1,
72
72
  max_delay: 60.0,
73
73
  multiplier: 1.3,
74
- retry_codes: ["UNAVAILABLE"]
74
+ retry_codes: [14]
75
75
  }
76
76
 
77
77
  default_config.rpcs.update_topic.timeout = 60.0
@@ -79,7 +79,7 @@ module Google
79
79
  initial_delay: 0.1,
80
80
  max_delay: 60.0,
81
81
  multiplier: 1.3,
82
- retry_codes: ["UNAVAILABLE"]
82
+ retry_codes: [14]
83
83
  }
84
84
 
85
85
  default_config.rpcs.publish.timeout = 60.0
@@ -87,7 +87,7 @@ module Google
87
87
  initial_delay: 0.1,
88
88
  max_delay: 60.0,
89
89
  multiplier: 1.3,
90
- retry_codes: ["ABORTED", "CANCELLED", "INTERNAL", "RESOURCE_EXHAUSTED", "UNKNOWN", "UNAVAILABLE", "DEADLINE_EXCEEDED"]
90
+ retry_codes: [10, 1, 13, 8, 2, 14, 4]
91
91
  }
92
92
 
93
93
  default_config.rpcs.get_topic.timeout = 60.0
@@ -95,7 +95,7 @@ module Google
95
95
  initial_delay: 0.1,
96
96
  max_delay: 60.0,
97
97
  multiplier: 1.3,
98
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
98
+ retry_codes: [2, 10, 14]
99
99
  }
100
100
 
101
101
  default_config.rpcs.list_topics.timeout = 60.0
@@ -103,7 +103,7 @@ module Google
103
103
  initial_delay: 0.1,
104
104
  max_delay: 60.0,
105
105
  multiplier: 1.3,
106
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
106
+ retry_codes: [2, 10, 14]
107
107
  }
108
108
 
109
109
  default_config.rpcs.list_topic_subscriptions.timeout = 60.0
@@ -111,7 +111,7 @@ module Google
111
111
  initial_delay: 0.1,
112
112
  max_delay: 60.0,
113
113
  multiplier: 1.3,
114
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
114
+ retry_codes: [2, 10, 14]
115
115
  }
116
116
 
117
117
  default_config.rpcs.list_topic_snapshots.timeout = 60.0
@@ -119,7 +119,7 @@ module Google
119
119
  initial_delay: 0.1,
120
120
  max_delay: 60.0,
121
121
  multiplier: 1.3,
122
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
122
+ retry_codes: [2, 10, 14]
123
123
  }
124
124
 
125
125
  default_config.rpcs.delete_topic.timeout = 60.0
@@ -127,7 +127,7 @@ module Google
127
127
  initial_delay: 0.1,
128
128
  max_delay: 60.0,
129
129
  multiplier: 1.3,
130
- retry_codes: ["UNAVAILABLE"]
130
+ retry_codes: [14]
131
131
  }
132
132
 
133
133
  default_config.rpcs.detach_subscription.timeout = 60.0
@@ -135,7 +135,7 @@ module Google
135
135
  initial_delay: 0.1,
136
136
  max_delay: 60.0,
137
137
  multiplier: 1.3,
138
- retry_codes: ["UNAVAILABLE"]
138
+ retry_codes: [14]
139
139
  }
140
140
 
141
141
  default_config
@@ -218,9 +218,8 @@ module Google
218
218
  # Service calls
219
219
 
220
220
  ##
221
- # Creates the given topic with the given name. See the
222
- # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
223
- # resource name rules</a>.
221
+ # Creates the given topic with the given name. See the [resource name rules](
222
+ # https://cloud.google.com/pubsub/docs/admin#resource_names).
224
223
  #
225
224
  # @overload create_topic(request, options = nil)
226
225
  # Pass arguments to `create_topic` via a request object, either of type
@@ -245,8 +244,8 @@ module Google
245
244
  # signs (`%`). It must be between 3 and 255 characters in length, and it
246
245
  # must not start with `"goog"`.
247
246
  # @param labels [::Hash{::String => ::String}]
248
- # See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
249
- # managing labels</a>.
247
+ # See [Creating and managing labels]
248
+ # (https://cloud.google.com/pubsub/docs/labels).
250
249
  # @param message_storage_policy [::Google::Cloud::PubSub::V1::MessageStoragePolicy, ::Hash]
251
250
  # Policy constraining the set of Google Cloud Platform regions where messages
252
251
  # published to the topic may be stored. If not present, then no constraints
@@ -661,11 +660,10 @@ module Google
661
660
 
662
661
  ##
663
662
  # Lists the names of the snapshots on this topic. Snapshots are used in
664
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
665
- # operations, which allow
666
- # you to manage message acknowledgments in bulk. That is, you can set the
667
- # acknowledgment state of messages in an existing subscription to the state
668
- # captured by a snapshot.
663
+ # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
664
+ # which allow you to manage message acknowledgments in bulk. That is, you can
665
+ # set the acknowledgment state of messages in an existing subscription to the
666
+ # state captured by a snapshot.
669
667
  #
670
668
  # @overload list_topic_snapshots(request, options = nil)
671
669
  # Pass arguments to `list_topic_snapshots` via a request object, either of type
@@ -72,7 +72,7 @@ module Google
72
72
  initial_delay: 0.1,
73
73
  max_delay: 60.0,
74
74
  multiplier: 1.3,
75
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
75
+ retry_codes: [2, 10, 14]
76
76
  }
77
77
 
78
78
  default_config.rpcs.get_subscription.timeout = 60.0
@@ -80,7 +80,7 @@ module Google
80
80
  initial_delay: 0.1,
81
81
  max_delay: 60.0,
82
82
  multiplier: 1.3,
83
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
83
+ retry_codes: [2, 10, 14]
84
84
  }
85
85
 
86
86
  default_config.rpcs.update_subscription.timeout = 60.0
@@ -88,7 +88,7 @@ module Google
88
88
  initial_delay: 0.1,
89
89
  max_delay: 60.0,
90
90
  multiplier: 1.3,
91
- retry_codes: ["UNAVAILABLE"]
91
+ retry_codes: [14]
92
92
  }
93
93
 
94
94
  default_config.rpcs.list_subscriptions.timeout = 60.0
@@ -96,7 +96,7 @@ module Google
96
96
  initial_delay: 0.1,
97
97
  max_delay: 60.0,
98
98
  multiplier: 1.3,
99
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
99
+ retry_codes: [2, 10, 14]
100
100
  }
101
101
 
102
102
  default_config.rpcs.delete_subscription.timeout = 60.0
@@ -104,7 +104,7 @@ module Google
104
104
  initial_delay: 0.1,
105
105
  max_delay: 60.0,
106
106
  multiplier: 1.3,
107
- retry_codes: ["UNAVAILABLE"]
107
+ retry_codes: [14]
108
108
  }
109
109
 
110
110
  default_config.rpcs.modify_ack_deadline.timeout = 60.0
@@ -112,7 +112,7 @@ module Google
112
112
  initial_delay: 0.1,
113
113
  max_delay: 60.0,
114
114
  multiplier: 1.3,
115
- retry_codes: ["UNAVAILABLE"]
115
+ retry_codes: [14]
116
116
  }
117
117
 
118
118
  default_config.rpcs.acknowledge.timeout = 60.0
@@ -120,7 +120,7 @@ module Google
120
120
  initial_delay: 0.1,
121
121
  max_delay: 60.0,
122
122
  multiplier: 1.3,
123
- retry_codes: ["UNAVAILABLE"]
123
+ retry_codes: [14]
124
124
  }
125
125
 
126
126
  default_config.rpcs.pull.timeout = 60.0
@@ -128,7 +128,7 @@ module Google
128
128
  initial_delay: 0.1,
129
129
  max_delay: 60.0,
130
130
  multiplier: 1.3,
131
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
131
+ retry_codes: [2, 10, 14]
132
132
  }
133
133
 
134
134
  default_config.rpcs.streaming_pull.timeout = 900.0
@@ -136,7 +136,7 @@ module Google
136
136
  initial_delay: 0.1,
137
137
  max_delay: 60.0,
138
138
  multiplier: 1.3,
139
- retry_codes: ["DEADLINE_EXCEEDED", "RESOURCE_EXHAUSTED", "ABORTED", "INTERNAL", "UNAVAILABLE"]
139
+ retry_codes: [4, 8, 10, 13, 14]
140
140
  }
141
141
 
142
142
  default_config.rpcs.modify_push_config.timeout = 60.0
@@ -144,7 +144,7 @@ module Google
144
144
  initial_delay: 0.1,
145
145
  max_delay: 60.0,
146
146
  multiplier: 1.3,
147
- retry_codes: ["UNAVAILABLE"]
147
+ retry_codes: [14]
148
148
  }
149
149
 
150
150
  default_config.rpcs.get_snapshot.timeout = 60.0
@@ -152,7 +152,7 @@ module Google
152
152
  initial_delay: 0.1,
153
153
  max_delay: 60.0,
154
154
  multiplier: 1.3,
155
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
155
+ retry_codes: [2, 10, 14]
156
156
  }
157
157
 
158
158
  default_config.rpcs.list_snapshots.timeout = 60.0
@@ -160,7 +160,7 @@ module Google
160
160
  initial_delay: 0.1,
161
161
  max_delay: 60.0,
162
162
  multiplier: 1.3,
163
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
163
+ retry_codes: [2, 10, 14]
164
164
  }
165
165
 
166
166
  default_config.rpcs.create_snapshot.timeout = 60.0
@@ -168,7 +168,7 @@ module Google
168
168
  initial_delay: 0.1,
169
169
  max_delay: 60.0,
170
170
  multiplier: 1.3,
171
- retry_codes: ["UNAVAILABLE"]
171
+ retry_codes: [14]
172
172
  }
173
173
 
174
174
  default_config.rpcs.update_snapshot.timeout = 60.0
@@ -176,7 +176,7 @@ module Google
176
176
  initial_delay: 0.1,
177
177
  max_delay: 60.0,
178
178
  multiplier: 1.3,
179
- retry_codes: ["UNAVAILABLE"]
179
+ retry_codes: [14]
180
180
  }
181
181
 
182
182
  default_config.rpcs.delete_snapshot.timeout = 60.0
@@ -184,7 +184,7 @@ module Google
184
184
  initial_delay: 0.1,
185
185
  max_delay: 60.0,
186
186
  multiplier: 1.3,
187
- retry_codes: ["UNAVAILABLE"]
187
+ retry_codes: [14]
188
188
  }
189
189
 
190
190
  default_config.rpcs.seek.timeout = 60.0
@@ -192,7 +192,7 @@ module Google
192
192
  initial_delay: 0.1,
193
193
  max_delay: 60.0,
194
194
  multiplier: 1.3,
195
- retry_codes: ["UNKNOWN", "ABORTED", "UNAVAILABLE"]
195
+ retry_codes: [2, 10, 14]
196
196
  }
197
197
 
198
198
  default_config
@@ -275,19 +275,17 @@ module Google
275
275
  # Service calls
276
276
 
277
277
  ##
278
- # Creates a subscription to a given topic. See the
279
- # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
280
- # resource name rules</a>.
278
+ # Creates a subscription to a given topic. See the [resource name rules]
279
+ # (https://cloud.google.com/pubsub/docs/admin#resource_names).
281
280
  # If the subscription already exists, returns `ALREADY_EXISTS`.
282
281
  # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
283
282
  #
284
283
  # If the name is not provided in the request, the server will assign a random
285
284
  # name for this subscription on the same project as the topic, conforming
286
- # to the
287
- # [resource name
288
- # format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
289
- # generated name is populated in the returned Subscription object. Note that
290
- # for REST API requests, you must specify a name in the request.
285
+ # to the [resource name format]
286
+ # (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
287
+ # name is populated in the returned Subscription object. Note that for REST
288
+ # API requests, you must specify a name in the request.
291
289
  #
292
290
  # @overload create_subscription(request, options = nil)
293
291
  # Pass arguments to `create_subscription` via a request object, either of type
@@ -344,10 +342,8 @@ module Google
344
342
  # Indicates whether to retain acknowledged messages. If true, then
345
343
  # messages are not expunged from the subscription's backlog, even if they are
346
344
  # acknowledged, until they fall out of the `message_retention_duration`
347
- # window. This must be true if you would like to
348
- # <a
349
- # href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
350
- # Seek to a timestamp</a>.
345
+ # window. This must be true if you would like to [Seek to a timestamp]
346
+ # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time).
351
347
  # @param message_retention_duration [::Google::Protobuf::Duration, ::Hash]
352
348
  # How long to retain unacknowledged messages in the subscription's backlog,
353
349
  # from the moment a message is published.
@@ -363,9 +359,6 @@ module Google
363
359
  # will be delivered to the subscribers in the order in which they
364
360
  # are received by the Pub/Sub system. Otherwise, they may be delivered in
365
361
  # any order.
366
- # <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
367
- # API might be changed in backward-incompatible ways and is not recommended
368
- # for production use. It is not subject to any SLA or deprecation policy.
369
362
  # @param expiration_policy [::Google::Cloud::PubSub::V1::ExpirationPolicy, ::Hash]
370
363
  # A policy that specifies the conditions for this subscription's expiration.
371
364
  # A subscription is considered active as long as any connected subscriber is
@@ -1179,12 +1172,11 @@ module Google
1179
1172
  end
1180
1173
 
1181
1174
  ##
1182
- # Lists the existing snapshots. Snapshots are used in
1183
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
1184
- # operations, which allow
1185
- # you to manage message acknowledgments in bulk. That is, you can set the
1186
- # acknowledgment state of messages in an existing subscription to the state
1187
- # captured by a snapshot.
1175
+ # Lists the existing snapshots. Snapshots are used in [Seek](
1176
+ # https://cloud.google.com/pubsub/docs/replay-overview) operations, which
1177
+ # allow you to manage message acknowledgments in bulk. That is, you can set
1178
+ # the acknowledgment state of messages in an existing subscription to the
1179
+ # state captured by a snapshot.
1188
1180
  #
1189
1181
  # @overload list_snapshots(request, options = nil)
1190
1182
  # Pass arguments to `list_snapshots` via a request object, either of type
@@ -1259,21 +1251,19 @@ module Google
1259
1251
 
1260
1252
  ##
1261
1253
  # Creates a snapshot from the requested subscription. Snapshots are used in
1262
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
1263
- # operations, which allow
1264
- # you to manage message acknowledgments in bulk. That is, you can set the
1265
- # acknowledgment state of messages in an existing subscription to the state
1266
- # captured by a snapshot.
1267
- # <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
1254
+ # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
1255
+ # which allow you to manage message acknowledgments in bulk. That is, you can
1256
+ # set the acknowledgment state of messages in an existing subscription to the
1257
+ # state captured by a snapshot.
1258
+ # If the snapshot already exists, returns `ALREADY_EXISTS`.
1268
1259
  # If the requested subscription doesn't exist, returns `NOT_FOUND`.
1269
1260
  # If the backlog in the subscription is too old -- and the resulting snapshot
1270
1261
  # would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
1271
1262
  # See also the `Snapshot.expire_time` field. If the name is not provided in
1272
1263
  # the request, the server will assign a random
1273
1264
  # name for this snapshot on the same project as the subscription, conforming
1274
- # to the
1275
- # [resource name
1276
- # format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
1265
+ # to the [resource name format]
1266
+ # (https://cloud.google.com/pubsub/docs/admin#resource_names). The
1277
1267
  # generated name is populated in the returned Snapshot object. Note that for
1278
1268
  # REST API requests, you must specify a name in the request.
1279
1269
  #
@@ -1433,12 +1423,11 @@ module Google
1433
1423
  end
1434
1424
 
1435
1425
  ##
1436
- # Removes an existing snapshot. Snapshots are used in
1437
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
1438
- # operations, which allow
1439
- # you to manage message acknowledgments in bulk. That is, you can set the
1440
- # acknowledgment state of messages in an existing subscription to the state
1441
- # captured by a snapshot.<br><br>
1426
+ # Removes an existing snapshot. Snapshots are used in [Seek]
1427
+ # (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
1428
+ # allow you to manage message acknowledgments in bulk. That is, you can set
1429
+ # the acknowledgment state of messages in an existing subscription to the
1430
+ # state captured by a snapshot.
1442
1431
  # When the snapshot is deleted, all messages retained in the snapshot
1443
1432
  # are immediately dropped. After a snapshot is deleted, a new one may be
1444
1433
  # created with the same name, but the new one has no association with the old
@@ -1510,13 +1499,12 @@ module Google
1510
1499
 
1511
1500
  ##
1512
1501
  # Seeks an existing subscription to a point in time or to a given snapshot,
1513
- # whichever is provided in the request. Snapshots are used in
1514
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
1515
- # operations, which allow
1516
- # you to manage message acknowledgments in bulk. That is, you can set the
1517
- # acknowledgment state of messages in an existing subscription to the state
1518
- # captured by a snapshot. Note that both the subscription and the snapshot
1519
- # must be on the same topic.
1502
+ # whichever is provided in the request. Snapshots are used in [Seek](
1503
+ # https://cloud.google.com/pubsub/docs/replay-overview) operations, which
1504
+ # allow you to manage message acknowledgments in bulk. That is, you can set
1505
+ # the acknowledgment state of messages in an existing subscription to the
1506
+ # state captured by a snapshot. Note that both the subscription and the
1507
+ # snapshot must be on the same topic.
1520
1508
  #
1521
1509
  # @overload seek(request, options = nil)
1522
1510
  # Pass arguments to `seek` via a request object, either of type
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module PubSub
23
23
  module V1
24
- VERSION = "0.1.0"
24
+ VERSION = "0.1.1"
25
25
  end
26
26
  end
27
27
  end
@@ -59,11 +59,11 @@ module Google
59
59
 
60
60
  # Sets the access control policy on the specified resource. Replaces any
61
61
  # existing policy.
62
- rpc :SetIamPolicy, SetIamPolicyRequest, Policy
62
+ rpc :SetIamPolicy, Google::Iam::V1::SetIamPolicyRequest, Google::Iam::V1::Policy
63
63
  # Gets the access control policy for a resource.
64
64
  # Returns an empty policy if the resource exists and does not have a policy
65
65
  # set.
66
- rpc :GetIamPolicy, GetIamPolicyRequest, Policy
66
+ rpc :GetIamPolicy, Google::Iam::V1::GetIamPolicyRequest, Google::Iam::V1::Policy
67
67
  # Returns permissions that a caller has on the specified resource.
68
68
  # If the resource does not exist, this will return an empty set of
69
69
  # permissions, not a NOT_FOUND error.
@@ -71,7 +71,7 @@ module Google
71
71
  # Note: This operation is designed to be used for building permission-aware
72
72
  # UIs and command-line tools, not for authorization checking. This operation
73
73
  # may "fail open" without warning.
74
- rpc :TestIamPermissions, TestIamPermissionsRequest, TestIamPermissionsResponse
74
+ rpc :TestIamPermissions, Google::Iam::V1::TestIamPermissionsRequest, Google::Iam::V1::TestIamPermissionsResponse
75
75
  end
76
76
 
77
77
  Stub = Service.rpc_stub_class
@@ -34,9 +34,8 @@ module Google
34
34
  self.unmarshal_class_method = :decode
35
35
  self.service_name = 'google.pubsub.v1.Publisher'
36
36
 
37
- # Creates the given topic with the given name. See the
38
- # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
39
- # resource name rules</a>.
37
+ # Creates the given topic with the given name. See the [resource name rules](
38
+ # https://cloud.google.com/pubsub/docs/admin#resource_names).
40
39
  rpc :CreateTopic, Google::Cloud::PubSub::V1::Topic, Google::Cloud::PubSub::V1::Topic
41
40
  # Updates an existing topic. Note that certain properties of a
42
41
  # topic are not modifiable.
@@ -51,11 +50,10 @@ module Google
51
50
  # Lists the names of the attached subscriptions on this topic.
52
51
  rpc :ListTopicSubscriptions, Google::Cloud::PubSub::V1::ListTopicSubscriptionsRequest, Google::Cloud::PubSub::V1::ListTopicSubscriptionsResponse
53
52
  # Lists the names of the snapshots on this topic. Snapshots are used in
54
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
55
- # operations, which allow
56
- # you to manage message acknowledgments in bulk. That is, you can set the
57
- # acknowledgment state of messages in an existing subscription to the state
58
- # captured by a snapshot.
53
+ # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
54
+ # which allow you to manage message acknowledgments in bulk. That is, you can
55
+ # set the acknowledgment state of messages in an existing subscription to the
56
+ # state captured by a snapshot.
59
57
  rpc :ListTopicSnapshots, Google::Cloud::PubSub::V1::ListTopicSnapshotsRequest, Google::Cloud::PubSub::V1::ListTopicSnapshotsResponse
60
58
  # Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
61
59
  # does not exist. After a topic is deleted, a new topic may be created with
@@ -84,19 +82,17 @@ module Google
84
82
  self.unmarshal_class_method = :decode
85
83
  self.service_name = 'google.pubsub.v1.Subscriber'
86
84
 
87
- # Creates a subscription to a given topic. See the
88
- # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
89
- # resource name rules</a>.
85
+ # Creates a subscription to a given topic. See the [resource name rules]
86
+ # (https://cloud.google.com/pubsub/docs/admin#resource_names).
90
87
  # If the subscription already exists, returns `ALREADY_EXISTS`.
91
88
  # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
92
89
  #
93
90
  # If the name is not provided in the request, the server will assign a random
94
91
  # name for this subscription on the same project as the topic, conforming
95
- # to the
96
- # [resource name
97
- # format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
98
- # generated name is populated in the returned Subscription object. Note that
99
- # for REST API requests, you must specify a name in the request.
92
+ # to the [resource name format]
93
+ # (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
94
+ # name is populated in the returned Subscription object. Note that for REST
95
+ # API requests, you must specify a name in the request.
100
96
  rpc :CreateSubscription, Google::Cloud::PubSub::V1::Subscription, Google::Cloud::PubSub::V1::Subscription
101
97
  # Gets the configuration details of a subscription.
102
98
  rpc :GetSubscription, Google::Cloud::PubSub::V1::GetSubscriptionRequest, Google::Cloud::PubSub::V1::Subscription
@@ -150,29 +146,26 @@ module Google
150
146
  # is, you can set the acknowledgment state of messages in an existing
151
147
  # subscription to the state captured by a snapshot.
152
148
  rpc :GetSnapshot, Google::Cloud::PubSub::V1::GetSnapshotRequest, Google::Cloud::PubSub::V1::Snapshot
153
- # Lists the existing snapshots. Snapshots are used in
154
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
155
- # operations, which allow
156
- # you to manage message acknowledgments in bulk. That is, you can set the
157
- # acknowledgment state of messages in an existing subscription to the state
158
- # captured by a snapshot.
149
+ # Lists the existing snapshots. Snapshots are used in [Seek](
150
+ # https://cloud.google.com/pubsub/docs/replay-overview) operations, which
151
+ # allow you to manage message acknowledgments in bulk. That is, you can set
152
+ # the acknowledgment state of messages in an existing subscription to the
153
+ # state captured by a snapshot.
159
154
  rpc :ListSnapshots, Google::Cloud::PubSub::V1::ListSnapshotsRequest, Google::Cloud::PubSub::V1::ListSnapshotsResponse
160
155
  # Creates a snapshot from the requested subscription. Snapshots are used in
161
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
162
- # operations, which allow
163
- # you to manage message acknowledgments in bulk. That is, you can set the
164
- # acknowledgment state of messages in an existing subscription to the state
165
- # captured by a snapshot.
166
- # <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
156
+ # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
157
+ # which allow you to manage message acknowledgments in bulk. That is, you can
158
+ # set the acknowledgment state of messages in an existing subscription to the
159
+ # state captured by a snapshot.
160
+ # If the snapshot already exists, returns `ALREADY_EXISTS`.
167
161
  # If the requested subscription doesn't exist, returns `NOT_FOUND`.
168
162
  # If the backlog in the subscription is too old -- and the resulting snapshot
169
163
  # would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
170
164
  # See also the `Snapshot.expire_time` field. If the name is not provided in
171
165
  # the request, the server will assign a random
172
166
  # name for this snapshot on the same project as the subscription, conforming
173
- # to the
174
- # [resource name
175
- # format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
167
+ # to the [resource name format]
168
+ # (https://cloud.google.com/pubsub/docs/admin#resource_names). The
176
169
  # generated name is populated in the returned Snapshot object. Note that for
177
170
  # REST API requests, you must specify a name in the request.
178
171
  rpc :CreateSnapshot, Google::Cloud::PubSub::V1::CreateSnapshotRequest, Google::Cloud::PubSub::V1::Snapshot
@@ -183,25 +176,23 @@ module Google
183
176
  # acknowledgment state of messages in an existing subscription to the state
184
177
  # captured by a snapshot.
185
178
  rpc :UpdateSnapshot, Google::Cloud::PubSub::V1::UpdateSnapshotRequest, Google::Cloud::PubSub::V1::Snapshot
186
- # Removes an existing snapshot. Snapshots are used in
187
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
188
- # operations, which allow
189
- # you to manage message acknowledgments in bulk. That is, you can set the
190
- # acknowledgment state of messages in an existing subscription to the state
191
- # captured by a snapshot.<br><br>
179
+ # Removes an existing snapshot. Snapshots are used in [Seek]
180
+ # (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
181
+ # allow you to manage message acknowledgments in bulk. That is, you can set
182
+ # the acknowledgment state of messages in an existing subscription to the
183
+ # state captured by a snapshot.
192
184
  # When the snapshot is deleted, all messages retained in the snapshot
193
185
  # are immediately dropped. After a snapshot is deleted, a new one may be
194
186
  # created with the same name, but the new one has no association with the old
195
187
  # snapshot or its subscription, unless the same subscription is specified.
196
188
  rpc :DeleteSnapshot, Google::Cloud::PubSub::V1::DeleteSnapshotRequest, Google::Protobuf::Empty
197
189
  # Seeks an existing subscription to a point in time or to a given snapshot,
198
- # whichever is provided in the request. Snapshots are used in
199
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
200
- # operations, which allow
201
- # you to manage message acknowledgments in bulk. That is, you can set the
202
- # acknowledgment state of messages in an existing subscription to the state
203
- # captured by a snapshot. Note that both the subscription and the snapshot
204
- # must be on the same topic.
190
+ # whichever is provided in the request. Snapshots are used in [Seek](
191
+ # https://cloud.google.com/pubsub/docs/replay-overview) operations, which
192
+ # allow you to manage message acknowledgments in bulk. That is, you can set
193
+ # the acknowledgment state of messages in an existing subscription to the
194
+ # state captured by a snapshot. Note that both the subscription and the
195
+ # snapshot must be on the same topic.
205
196
  rpc :Seek, Google::Cloud::PubSub::V1::SeekRequest, Google::Cloud::PubSub::V1::SeekResponse
206
197
  end
207
198
 
@@ -45,8 +45,8 @@ module Google
45
45
  # must not start with `"goog"`.
46
46
  # @!attribute [rw] labels
47
47
  # @return [::Google::Protobuf::Map{::String => ::String}]
48
- # See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
49
- # managing labels</a>.
48
+ # See [Creating and managing labels]
49
+ # (https://cloud.google.com/pubsub/docs/labels).
50
50
  # @!attribute [rw] message_storage_policy
51
51
  # @return [::Google::Cloud::PubSub::V1::MessageStoragePolicy]
52
52
  # Policy constraining the set of Google Cloud Platform regions where messages
@@ -75,11 +75,11 @@ module Google
75
75
  # A message that is published by publishers and consumed by subscribers. The
76
76
  # message must contain either a non-empty data field or at least one attribute.
77
77
  # Note that client libraries represent this object differently
78
- # depending on the language. See the corresponding
79
- # <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
80
- # library documentation</a> for more information. See
81
- # <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
82
- # for more information about message limits.
78
+ # depending on the language. See the corresponding [client library
79
+ # documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
80
+ # more information. See [quotas and limits]
81
+ # (https://cloud.google.com/pubsub/quotas) for more information about message
82
+ # limits.
83
83
  # @!attribute [rw] data
84
84
  # @return [::String]
85
85
  # The message data field. If this field is empty, the message must contain
@@ -108,9 +108,6 @@ module Google
108
108
  # delivered to subscribers in the order in which they are received by the
109
109
  # Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
110
110
  # must specify the same `ordering_key` value.
111
- # <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
112
- # API might be changed in backward-incompatible ways and is not recommended
113
- # for production use. It is not subject to any SLA or deprecation policy.
114
111
  class PubsubMessage
115
112
  include ::Google::Protobuf::MessageExts
116
113
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -343,10 +340,8 @@ module Google
343
340
  # Indicates whether to retain acknowledged messages. If true, then
344
341
  # messages are not expunged from the subscription's backlog, even if they are
345
342
  # acknowledged, until they fall out of the `message_retention_duration`
346
- # window. This must be true if you would like to
347
- # <a
348
- # href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
349
- # Seek to a timestamp</a>.
343
+ # window. This must be true if you would like to [Seek to a timestamp]
344
+ # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time).
350
345
  # @!attribute [rw] message_retention_duration
351
346
  # @return [::Google::Protobuf::Duration]
352
347
  # How long to retain unacknowledged messages in the subscription's backlog,
@@ -365,9 +360,6 @@ module Google
365
360
  # will be delivered to the subscribers in the order in which they
366
361
  # are received by the Pub/Sub system. Otherwise, they may be delivered in
367
362
  # any order.
368
- # <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
369
- # API might be changed in backward-incompatible ways and is not recommended
370
- # for production use. It is not subject to any SLA or deprecation policy.
371
363
  # @!attribute [rw] expiration_policy
372
364
  # @return [::Google::Cloud::PubSub::V1::ExpirationPolicy]
373
365
  # A policy that specifies the conditions for this subscription's expiration.
@@ -893,11 +885,10 @@ module Google
893
885
  end
894
886
 
895
887
  # A snapshot resource. Snapshots are used in
896
- # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
897
- # operations, which allow
898
- # you to manage message acknowledgments in bulk. That is, you can set the
899
- # acknowledgment state of messages in an existing subscription to the state
900
- # captured by a snapshot.
888
+ # [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
889
+ # operations, which allow you to manage message acknowledgments in bulk. That
890
+ # is, you can set the acknowledgment state of messages in an existing
891
+ # subscription to the state captured by a snapshot.
901
892
  # @!attribute [rw] name
902
893
  # @return [::String]
903
894
  # The name of the snapshot.
@@ -918,8 +909,8 @@ module Google
918
909
  # snapshot that would expire in less than 1 hour after creation.
919
910
  # @!attribute [rw] labels
920
911
  # @return [::Google::Protobuf::Map{::String => ::String}]
921
- # See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
922
- # managing labels</a>.
912
+ # See [Creating and managing labels]
913
+ # (https://cloud.google.com/pubsub/docs/labels).
923
914
  class Snapshot
924
915
  include ::Google::Protobuf::MessageExts
925
916
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-pubsub-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.1.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-08-03 00:00:00.000000000 Z
11
+ date: 2020-08-06 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common