Blame - docs/dyn/run_v1alpha1.namespaces.triggers.html - platform/external/python/google-api-python-client

<h1><a href="run_v1alpha1.html">Cloud Run API</a> . <a href="run_v1alpha1.namespaces.html">namespaces</a> . <a href="run_v1alpha1.namespaces.triggers.html">triggers</a></h1>

76

<h2>Instance Methods</h2>

77

78

<code><a href="#create">create(parent, body, x__xgafv=None)</a></code></p>

79

<p class="firstline">Creates a new trigger.</p>

80

81

<code><a href="#delete">delete(name, kind=None, propagationPolicy=None, apiVersion=None, x__xgafv=None)</a></code></p>

82

<p class="firstline">Rpc to delete a trigger.</p>

83

84

<code><a href="#get">get(name, x__xgafv=None)</a></code></p>

85

<p class="firstline">Rpc to get information about a trigger.</p>

86

87

<code><a href="#list">list(parent, labelSelector=None, includeUninitialized=None, x__xgafv=None, resourceVersion=None, limit=None, watch=None, continue=None, fieldSelector=None)</a></code></p>

88

<p class="firstline">Rpc to list triggers.</p>

89

90

<code><a href="#replaceTrigger">replaceTrigger(name, body, x__xgafv=None)</a></code></p>

91

<p class="firstline">Rpc to replace a trigger.</p>

92

<h3>Method Details</h3>

93

94

<code class="details" id="create">create(parent, body, x__xgafv=None)</code>

95

<pre>Creates a new trigger.

96

97

Args:

98

parent: string, The project ID or project number in which this trigger should

99

be created. (required)

100

body: object, The request body. (required)

101

The object takes the form of:

102

103

{

104

"status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of

105

# date.

106

# +optional

107

"observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that

108

# was last processed by the controller.

109

"conditions": [ # Array of observed TriggerConditions, indicating the current state

110

# of the Trigger.

111

{ # TriggerCondition contains state information for an Trigger.

112

"status": "A String", # Status of the condition, one of True, False, Unknown.

113

"severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info

114

# +optional

115

"lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.

116

# +optional

117

"reason": "A String", # One-word CamelCase reason for the condition's current status.

118

# +optional

119

"message": "A String", # Human readable message indicating details about the current status.

120

# +optional

121

"type": "A String", # Type of Trigger condition.

122

},

123

],

124

"subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger.

125

},

126

"kind": "A String", # The kind of resource, in this case "Trigger".

127

"spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger.

128

"filter": { # Filter is the filter to apply against all events from the Broker. Only

129

# events that pass this filter will be sent to the Subscriber. If not

130

# specified, will default to allowing all events.

131

#

132

# This must be specified in Cloud Run.

133

"sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud

134

# event's type and source attributes. Only exact matches will pass the filter.

135

"source": "A String",

"type": "A String",

},

},

"subscriber": { # Subscriber is the addressable that receives events from the Broker that

140

# pass the Filter. It is required.

141

#

142

# E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or

143

# /namespaces/my-project/services/my-service.

144

"ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target

145

# endpoint, which should implement the Addressable duck type.

146

# For example, this could be a reference to a Route resource

147

# or a Knative Service resource.

148

# referred object.

149

"kind": "A String", # Kind of the referent.

150

# More info:

151

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

152

# +optional

153

"uid": "A String", # UID of the referent.

154

# More info:

155

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

156

# +optional

157

"namespace": "A String", # Namespace of the referent.

158

# More info:

159

# https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

160

# +optional

161

"apiVersion": "A String", # API version of the referent.

162

# +optional

163

"fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this

164

# string should contain a valid JSON/Go field access statement, such as

165

# desiredState.manifest.containers[2]. For example, if the object reference

166

# is to a container within a pod, this would take on a value like:

167

# "spec.containers{name}" (where "name" refers to the name of the container

168

# that triggered the event) or if no container name is specified

169

# "spec.containers[2]" (container with index 2 in this pod). This syntax is

170

# chosen only to have some well-defined way of referencing a part of an

171

# object.

172

"resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any.

173

# More info:

174

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

175

# +optional

176

"name": "A String", # Name of the referent.

177

# More info:

178

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

179

# +optional

180

},

181

"uri": "A String", # Reference to a 'known' endpoint where no resolving is done.

182

# http://k8s-service for example

183

# http://myexternalhandler.example.com/foo/bar

184

},

185

"broker": "A String", # Broker is the broker that this trigger receives events from. If not

186

# specified, will default to 'default'.

187

#

188

# Not currently supported by Cloud Run.

189

},

190

"apiVersion": "A String", # The API version for this call such as "v1alpha1".

191

"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger.

192

# all objects users must create.

193

"ownerReferences": [ # List of objects that own this object. If ALL objects in the list have

194

# been deleted, this object will be garbage collected.

195

# +optional

196

{ # OwnerReference contains enough information to let you identify an owning

197

# object. Currently, an owning object must be in the same namespace, so there

198

# is no namespace field.

199

"kind": "A String", # Kind of the referent.

200

# More info:

201

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

202

"uid": "A String", # UID of the referent.

203

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

204

"apiVersion": "A String", # API version of the referent.

205

"controller": True or False, # If true, this reference points to the managing controller.

206

# +optional

207

"blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then

208

# the owner cannot be deleted from the key-value store until this

209

# reference is removed.

210

# Defaults to false.

211

# To set this field, a user needs "delete" permission of the owner,

212

# otherwise 422 (Unprocessable Entity) will be returned.

213

# +optional

214

"name": "A String", # Name of the referent.

215

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

216

},

217

],

218

"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.

219

# Is required when creating

220

# resources, although some resources may allow a client to request the

221

# generation of an appropriate name automatically. Name is primarily intended

222

# for creation idempotence and configuration definition. Cannot be updated.

223

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

224

# +optional

225

"deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be

226

# deleted. This field is set by the server when a graceful deletion is

227

# requested by the user, and is not directly settable by a client. The

228

# resource is expected to be deleted (no longer visible from resource lists,

229

# and not reachable by name) after the time in this field, once the

230

# finalizers list is empty. As long as the finalizers list contains items,

231

# deletion is blocked. Once the deletionTimestamp is set, this value may not

232

# be unset or be set further into the future, although it may be shortened or

233

# the resource may be deleted prior to this time. For example, a user may

234

# request that a pod is deleted in 30 seconds. The Kubelet will react by

235

# sending a graceful termination signal to the containers in the pod. After

236

# that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)

237

# to the container and after cleanup, remove the pod from the API. In the

238

# presence of network partitions, this object may still exist after this

239

# timestamp, until an administrator or automated process can determine the

240

# resource is fully terminated.

241

# If not set, graceful deletion of the object has not been requested.

242

#

243

# Populated by the system when a graceful deletion is requested.

244

# Read-only.

245

# More info:

246

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

247

# +optional

248

"clusterName": "A String", # Not currently supported by Cloud Run.

249

#

250

# The name of the cluster which the object belongs to.

251

# This is used to distinguish resources with same name and namespace in

252

# different clusters. This field is not set anywhere right now and apiserver

253

# is going to ignore it if set in create or update request. +optional

254

"deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.

255

#

256

# Number of seconds allowed for this object to gracefully terminate before

257

# it will be removed from the system. Only set when deletionTimestamp is also

258

# set. May only be shortened. Read-only. +optional

259

"labels": { # Map of string keys and values that can be used to organize and categorize

260

# (scope and select) objects. May match selectors of replication controllers

261

# and routes.

262

# More info: http://kubernetes.io/docs/user-guide/labels

# +optional

"a_key": "A String",

},

"namespace": "A String", # Namespace defines the space within each name must be unique, within a

267

# Cloud Run region. In Cloud Run the namespace must be equal to either the

268

# project ID or project number.

269

"generation": 42, # A sequence number representing a specific generation of the desired state.

270

# Populated by the system. Read-only.

271

# +optional

272

"finalizers": [ # Not currently supported by Cloud Run.

273

#

274

# Must be empty before the object is deleted from the registry. Each entry

275

# is an identifier for the responsible component that will remove the entry

276

# from the list. If the deletionTimestamp of the object is non-nil, entries

277

# in this list can only be removed.

278

# +optional

279

# +patchStrategy=merge

280

"A String",

281

],

282

"initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.

283

#

284

# An initializer is a controller which enforces some system invariant at

285

# object creation time. This field is a list of initializers that have not

286

# yet acted on this object. If nil or empty, this object has been completely

287

# initialized. Otherwise, the object is considered uninitialized and is

288

# hidden (in list/watch and get calls) from clients that haven't explicitly

289

# asked to observe uninitialized objects.

290

#

291

# When an object is created, the system will populate this list with the

292

# current set of initializers. Only privileged users may set or modify this

293

# list. Once it is empty, it may not be modified further by any user.

294

"pending": [ # Pending is a list of initializers that must execute in order before this

295

# object is visible. When the last pending initializer is removed, and no

296

# failing result is set, the initializers struct will be set to nil and the

297

# object is considered as initialized and visible to all clients.

298

# +patchMergeKey=name

299

# +patchStrategy=merge

300

{ # Initializer is information about an initializer that has not yet completed.

301

"name": "A String", # name of the process that is responsible for initializing this object.

},

],

},

"resourceVersion": "A String", # An opaque value that represents the internal version of this object that

306

# can be used by clients to determine when objects have changed. May be used

307

# for optimistic concurrency, change detection, and the watch operation on a

308

# resource or set of resources. Clients must treat these values as opaque and

309

# passed unmodified back to the server. They may only be valid for a

310

# particular resource or set of resources.

311

#

312

# Populated by the system.

313

# Read-only.

314

# Value must be treated as opaque by clients and .

315

# More info:

316

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

317

# +optional

318

"generateName": "A String", # Not currently supported by Cloud Run.

319

#

320

# GenerateName is an optional prefix, used by the server, to generate a

321

# unique name ONLY IF the Name field has not been provided. If this field is

322

# used, the name returned to the client will be different than the name

323

# passed. This value will also be combined with a unique suffix. The provided

324

# value has the same validation rules as the Name field, and may be truncated

325

# by the length of the suffix required to make the value unique on the

326

# server.

327

#

328

# If this field is specified and the generated name exists, the server will

329

# NOT return a 409 - instead, it will either return 201 Created or 500 with

330

# Reason ServerTimeout indicating a unique name could not be found in the

331

# time allotted, and the client should retry (optionally after the time

332

# indicated in the Retry-After header).

333

#

334

# Applied only if Name is not specified.

335

# More info:

336

# https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency

337

# +optional

338

# string generateName = 2;

339

"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this

340

# object was created. It is not guaranteed to be set in happens-before order

341

# across separate operations. Clients may not set this value. It is

342

# represented in RFC3339 form and is in UTC.

343

#

344

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

349

# +optional

350

"annotations": { # Annotations is an unstructured key value map stored with a resource that

351

# may be set by external tools to store and retrieve arbitrary metadata. They

352

# are not queryable and should be preserved when modifying objects. More

353

# info: http://kubernetes.io/docs/user-guide/annotations +optional

354

"a_key": "A String",

355

},

356

"selfLink": "A String", # SelfLink is a URL representing this object.

357

# Populated by the system.

358

# Read-only.

359

# +optional

360

# string selfLink = 4;

361

"uid": "A String", # UID is the unique in time and space value for this object. It is typically

362

# generated by the server on successful creation of a resource and is not

363

# allowed to change on PUT operations.

364

#

365

# Populated by the system.

366

# Read-only.

367

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

# +optional

},

}

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

379

380

{

381

"status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of

382

# date.

383

# +optional

384

"observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that

385

# was last processed by the controller.

386

"conditions": [ # Array of observed TriggerConditions, indicating the current state

387

# of the Trigger.

388

{ # TriggerCondition contains state information for an Trigger.

389

"status": "A String", # Status of the condition, one of True, False, Unknown.

390

"severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info

391

# +optional

392

"lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.

393

# +optional

394

"reason": "A String", # One-word CamelCase reason for the condition's current status.

395

# +optional

396

"message": "A String", # Human readable message indicating details about the current status.

397

# +optional

398

"type": "A String", # Type of Trigger condition.

399

},

400

],

401

"subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger.

402

},

403

"kind": "A String", # The kind of resource, in this case "Trigger".

404

"spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger.

405

"filter": { # Filter is the filter to apply against all events from the Broker. Only

406

# events that pass this filter will be sent to the Subscriber. If not

407

# specified, will default to allowing all events.

408

#

409

# This must be specified in Cloud Run.

410

"sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud

411

# event's type and source attributes. Only exact matches will pass the filter.

412

"source": "A String",

"type": "A String",

},

},

"subscriber": { # Subscriber is the addressable that receives events from the Broker that

417

# pass the Filter. It is required.

418

#

419

# E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or

420

# /namespaces/my-project/services/my-service.

421

"ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target

422

# endpoint, which should implement the Addressable duck type.

423

# For example, this could be a reference to a Route resource

424

# or a Knative Service resource.

425

# referred object.

426

"kind": "A String", # Kind of the referent.

427

# More info:

428

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

429

# +optional

430

"uid": "A String", # UID of the referent.

431

# More info:

432

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

433

# +optional

434

"namespace": "A String", # Namespace of the referent.

435

# More info:

436

# https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

437

# +optional

438

"apiVersion": "A String", # API version of the referent.

439

# +optional

440

"fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this

441

# string should contain a valid JSON/Go field access statement, such as

442

# desiredState.manifest.containers[2]. For example, if the object reference

443

# is to a container within a pod, this would take on a value like:

444

# "spec.containers{name}" (where "name" refers to the name of the container

445

# that triggered the event) or if no container name is specified

446

# "spec.containers[2]" (container with index 2 in this pod). This syntax is

447

# chosen only to have some well-defined way of referencing a part of an

448

# object.

449

"resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any.

450

# More info:

451

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

452

# +optional

453

"name": "A String", # Name of the referent.

454

# More info:

455

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

456

# +optional

457

},

458

"uri": "A String", # Reference to a 'known' endpoint where no resolving is done.

459

# http://k8s-service for example

460

# http://myexternalhandler.example.com/foo/bar

461

},

462

"broker": "A String", # Broker is the broker that this trigger receives events from. If not

463

# specified, will default to 'default'.

464

#

465

# Not currently supported by Cloud Run.

466

},

467

"apiVersion": "A String", # The API version for this call such as "v1alpha1".

468

"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger.

469

# all objects users must create.

470

"ownerReferences": [ # List of objects that own this object. If ALL objects in the list have

471

# been deleted, this object will be garbage collected.

472

# +optional

473

{ # OwnerReference contains enough information to let you identify an owning

474

# object. Currently, an owning object must be in the same namespace, so there

475

# is no namespace field.

476

"kind": "A String", # Kind of the referent.

477

# More info:

478

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

479

"uid": "A String", # UID of the referent.

480

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

481

"apiVersion": "A String", # API version of the referent.

482

"controller": True or False, # If true, this reference points to the managing controller.

483

# +optional

484

"blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then

485

# the owner cannot be deleted from the key-value store until this

486

# reference is removed.

487

# Defaults to false.

488

# To set this field, a user needs "delete" permission of the owner,

489

# otherwise 422 (Unprocessable Entity) will be returned.

490

# +optional

491

"name": "A String", # Name of the referent.

492

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

493

},

494

],

495

"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.

496

# Is required when creating

497

# resources, although some resources may allow a client to request the

498

# generation of an appropriate name automatically. Name is primarily intended

499

# for creation idempotence and configuration definition. Cannot be updated.

500

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

501

# +optional

502

"deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be

503

# deleted. This field is set by the server when a graceful deletion is

504

# requested by the user, and is not directly settable by a client. The

505

# resource is expected to be deleted (no longer visible from resource lists,

506

# and not reachable by name) after the time in this field, once the

507

# finalizers list is empty. As long as the finalizers list contains items,

508

# deletion is blocked. Once the deletionTimestamp is set, this value may not

509

# be unset or be set further into the future, although it may be shortened or

510

# the resource may be deleted prior to this time. For example, a user may

511

# request that a pod is deleted in 30 seconds. The Kubelet will react by

512

# sending a graceful termination signal to the containers in the pod. After

513

# that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)

514

# to the container and after cleanup, remove the pod from the API. In the

515

# presence of network partitions, this object may still exist after this

516

# timestamp, until an administrator or automated process can determine the

517

# resource is fully terminated.

518

# If not set, graceful deletion of the object has not been requested.

519

#

520

# Populated by the system when a graceful deletion is requested.

521

# Read-only.

522

# More info:

523

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

524

# +optional

525

"clusterName": "A String", # Not currently supported by Cloud Run.

526

#

527

# The name of the cluster which the object belongs to.

528

# This is used to distinguish resources with same name and namespace in

529

# different clusters. This field is not set anywhere right now and apiserver

530

# is going to ignore it if set in create or update request. +optional

531

"deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.

532

#

533

# Number of seconds allowed for this object to gracefully terminate before

534

# it will be removed from the system. Only set when deletionTimestamp is also

535

# set. May only be shortened. Read-only. +optional

536

"labels": { # Map of string keys and values that can be used to organize and categorize

537

# (scope and select) objects. May match selectors of replication controllers

538

# and routes.

539

# More info: http://kubernetes.io/docs/user-guide/labels

# +optional

"a_key": "A String",

},

"namespace": "A String", # Namespace defines the space within each name must be unique, within a

544

# Cloud Run region. In Cloud Run the namespace must be equal to either the

545

# project ID or project number.

546

"generation": 42, # A sequence number representing a specific generation of the desired state.

547

# Populated by the system. Read-only.

548

# +optional

549

"finalizers": [ # Not currently supported by Cloud Run.

550

#

551

# Must be empty before the object is deleted from the registry. Each entry

552

# is an identifier for the responsible component that will remove the entry

553

# from the list. If the deletionTimestamp of the object is non-nil, entries

554

# in this list can only be removed.

555

# +optional

556

# +patchStrategy=merge

557

"A String",

558

],

559

"initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.

560

#

561

# An initializer is a controller which enforces some system invariant at

562

# object creation time. This field is a list of initializers that have not

563

# yet acted on this object. If nil or empty, this object has been completely

564

# initialized. Otherwise, the object is considered uninitialized and is

565

# hidden (in list/watch and get calls) from clients that haven't explicitly

566

# asked to observe uninitialized objects.

567

#

568

# When an object is created, the system will populate this list with the

569

# current set of initializers. Only privileged users may set or modify this

570

# list. Once it is empty, it may not be modified further by any user.

571

"pending": [ # Pending is a list of initializers that must execute in order before this

572

# object is visible. When the last pending initializer is removed, and no

573

# failing result is set, the initializers struct will be set to nil and the

574

# object is considered as initialized and visible to all clients.

575

# +patchMergeKey=name

576

# +patchStrategy=merge

577

{ # Initializer is information about an initializer that has not yet completed.

578

"name": "A String", # name of the process that is responsible for initializing this object.

},

],

},

"resourceVersion": "A String", # An opaque value that represents the internal version of this object that

583

# can be used by clients to determine when objects have changed. May be used

584

# for optimistic concurrency, change detection, and the watch operation on a

585

# resource or set of resources. Clients must treat these values as opaque and

586

# passed unmodified back to the server. They may only be valid for a

587

# particular resource or set of resources.

588

#

589

# Populated by the system.

590

# Read-only.

591

# Value must be treated as opaque by clients and .

592

# More info:

593

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

594

# +optional

595

"generateName": "A String", # Not currently supported by Cloud Run.

596

#

597

# GenerateName is an optional prefix, used by the server, to generate a

598

# unique name ONLY IF the Name field has not been provided. If this field is

599

# used, the name returned to the client will be different than the name

600

# passed. This value will also be combined with a unique suffix. The provided

601

# value has the same validation rules as the Name field, and may be truncated

602

# by the length of the suffix required to make the value unique on the

603

# server.

604

#

605

# If this field is specified and the generated name exists, the server will

606

# NOT return a 409 - instead, it will either return 201 Created or 500 with

607

# Reason ServerTimeout indicating a unique name could not be found in the

608

# time allotted, and the client should retry (optionally after the time

609

# indicated in the Retry-After header).

610

#

611

# Applied only if Name is not specified.

612

# More info:

613

# https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency

614

# +optional

615

# string generateName = 2;

616

"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this

617

# object was created. It is not guaranteed to be set in happens-before order

618

# across separate operations. Clients may not set this value. It is

619

# represented in RFC3339 form and is in UTC.

620

#

621

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

626

# +optional

627

"annotations": { # Annotations is an unstructured key value map stored with a resource that

628

# may be set by external tools to store and retrieve arbitrary metadata. They

629

# are not queryable and should be preserved when modifying objects. More

630

# info: http://kubernetes.io/docs/user-guide/annotations +optional

631

"a_key": "A String",

632

},

633

"selfLink": "A String", # SelfLink is a URL representing this object.

634

# Populated by the system.

635

# Read-only.

636

# +optional

637

# string selfLink = 4;

638

"uid": "A String", # UID is the unique in time and space value for this object. It is typically

639

# generated by the server on successful creation of a resource and is not

640

# allowed to change on PUT operations.

641

#

642

# Populated by the system.

643

# Read-only.

644

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

# +optional

},

}</pre>

</div>

<code class="details" id="delete">delete(name, kind=None, propagationPolicy=None, apiVersion=None, x__xgafv=None)</code>

652

<pre>Rpc to delete a trigger.

Args:

{namespace_id} with the project ID. (required)

657

kind: string, Cloud Run currently ignores this parameter.

658

propagationPolicy: string, Specifies the propagation policy of delete. Cloud Run currently ignores

659

this setting, and deletes in the background. Please see

660

kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for

661

more information.

662

apiVersion: string, Cloud Run currently ignores this parameter.

663

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

670

671

{ # A generic empty message that you can re-use to avoid defining duplicated

672

# empty messages in your APIs. A typical example is to use it as the request

673

# or the response type of an API method. For instance:

674

#

675

# service Foo {

676

# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);

677

# }

678

#

679

# The JSON representation for `Empty` is empty JSON object `{}`.

}</pre>

</div>

<code class="details" id="get">get(name, x__xgafv=None)</code>

685

<pre>Rpc to get information about a trigger.

Args:

{namespace_id} with the project ID. (required)

690

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

697

698

{

699

"status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of

700

# date.

701

# +optional

702

"observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that

703

# was last processed by the controller.

704

"conditions": [ # Array of observed TriggerConditions, indicating the current state

705

# of the Trigger.

706

{ # TriggerCondition contains state information for an Trigger.

707

"status": "A String", # Status of the condition, one of True, False, Unknown.

708

"severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info

709

# +optional

710

"lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.

711

# +optional

712

"reason": "A String", # One-word CamelCase reason for the condition's current status.

713

# +optional

714

"message": "A String", # Human readable message indicating details about the current status.

715

# +optional

716

"type": "A String", # Type of Trigger condition.

717

},

718

],

719

"subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger.

720

},

721

"kind": "A String", # The kind of resource, in this case "Trigger".

722

"spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger.

723

"filter": { # Filter is the filter to apply against all events from the Broker. Only

724

# events that pass this filter will be sent to the Subscriber. If not

725

# specified, will default to allowing all events.

726

#

727

# This must be specified in Cloud Run.

728

"sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud

729

# event's type and source attributes. Only exact matches will pass the filter.

730

"source": "A String",

"type": "A String",

},

},

"subscriber": { # Subscriber is the addressable that receives events from the Broker that

735

# pass the Filter. It is required.

736

#

737

# E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or

738

# /namespaces/my-project/services/my-service.

739

"ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target

740

# endpoint, which should implement the Addressable duck type.

741

# For example, this could be a reference to a Route resource

742

# or a Knative Service resource.

743

# referred object.

744

"kind": "A String", # Kind of the referent.

745

# More info:

746

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

747

# +optional

748

"uid": "A String", # UID of the referent.

749

# More info:

750

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

751

# +optional

752

"namespace": "A String", # Namespace of the referent.

753

# More info:

754

# https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

755

# +optional

756

"apiVersion": "A String", # API version of the referent.

757

# +optional

758

"fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this

759

# string should contain a valid JSON/Go field access statement, such as

760

# desiredState.manifest.containers[2]. For example, if the object reference

761

# is to a container within a pod, this would take on a value like:

762

# "spec.containers{name}" (where "name" refers to the name of the container

763

# that triggered the event) or if no container name is specified

764

# "spec.containers[2]" (container with index 2 in this pod). This syntax is

765

# chosen only to have some well-defined way of referencing a part of an

766

# object.

767

"resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any.

768

# More info:

769

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

770

# +optional

771

"name": "A String", # Name of the referent.

772

# More info:

773

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

774

# +optional

775

},

776

"uri": "A String", # Reference to a 'known' endpoint where no resolving is done.

777

# http://k8s-service for example

778

# http://myexternalhandler.example.com/foo/bar

779

},

780

"broker": "A String", # Broker is the broker that this trigger receives events from. If not

781

# specified, will default to 'default'.

782

#

783

# Not currently supported by Cloud Run.

784

},

785

"apiVersion": "A String", # The API version for this call such as "v1alpha1".

786

"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger.

787

# all objects users must create.

788

"ownerReferences": [ # List of objects that own this object. If ALL objects in the list have

789

# been deleted, this object will be garbage collected.

790

# +optional

791

{ # OwnerReference contains enough information to let you identify an owning

792

# object. Currently, an owning object must be in the same namespace, so there

793

# is no namespace field.

794

"kind": "A String", # Kind of the referent.

795

# More info:

796

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

797

"uid": "A String", # UID of the referent.

798

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

799

"apiVersion": "A String", # API version of the referent.

800

"controller": True or False, # If true, this reference points to the managing controller.

801

# +optional

802

"blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then

803

# the owner cannot be deleted from the key-value store until this

804

# reference is removed.

805

# Defaults to false.

806

# To set this field, a user needs "delete" permission of the owner,

807

# otherwise 422 (Unprocessable Entity) will be returned.

808

# +optional

809

"name": "A String", # Name of the referent.

810

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

811

},

812

],

813

"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.

814

# Is required when creating

815

# resources, although some resources may allow a client to request the

816

# generation of an appropriate name automatically. Name is primarily intended

817

# for creation idempotence and configuration definition. Cannot be updated.

818

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

819

# +optional

820

"deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be

821

# deleted. This field is set by the server when a graceful deletion is

822

# requested by the user, and is not directly settable by a client. The

823

# resource is expected to be deleted (no longer visible from resource lists,

824

# and not reachable by name) after the time in this field, once the

825

# finalizers list is empty. As long as the finalizers list contains items,

826

# deletion is blocked. Once the deletionTimestamp is set, this value may not

827

# be unset or be set further into the future, although it may be shortened or

828

# the resource may be deleted prior to this time. For example, a user may

829

# request that a pod is deleted in 30 seconds. The Kubelet will react by

830

# sending a graceful termination signal to the containers in the pod. After

831

# that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)

832

# to the container and after cleanup, remove the pod from the API. In the

833

# presence of network partitions, this object may still exist after this

834

# timestamp, until an administrator or automated process can determine the

835

# resource is fully terminated.

836

# If not set, graceful deletion of the object has not been requested.

837

#

838

# Populated by the system when a graceful deletion is requested.

839

# Read-only.

840

# More info:

841

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

842

# +optional

843

"clusterName": "A String", # Not currently supported by Cloud Run.

844

#

845

# The name of the cluster which the object belongs to.

846

# This is used to distinguish resources with same name and namespace in

847

# different clusters. This field is not set anywhere right now and apiserver

848

# is going to ignore it if set in create or update request. +optional

849

"deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.

850

#

851

# Number of seconds allowed for this object to gracefully terminate before

852

# it will be removed from the system. Only set when deletionTimestamp is also

853

# set. May only be shortened. Read-only. +optional

854

"labels": { # Map of string keys and values that can be used to organize and categorize

855

# (scope and select) objects. May match selectors of replication controllers

856

# and routes.

857

# More info: http://kubernetes.io/docs/user-guide/labels

# +optional

"a_key": "A String",

},

"namespace": "A String", # Namespace defines the space within each name must be unique, within a

862

# Cloud Run region. In Cloud Run the namespace must be equal to either the

863

# project ID or project number.

864

"generation": 42, # A sequence number representing a specific generation of the desired state.

865

# Populated by the system. Read-only.

866

# +optional

867

"finalizers": [ # Not currently supported by Cloud Run.

868

#

869

# Must be empty before the object is deleted from the registry. Each entry

870

# is an identifier for the responsible component that will remove the entry

871

# from the list. If the deletionTimestamp of the object is non-nil, entries

872

# in this list can only be removed.

873

# +optional

874

# +patchStrategy=merge

875

"A String",

876

],

877

"initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.

878

#

879

# An initializer is a controller which enforces some system invariant at

880

# object creation time. This field is a list of initializers that have not

881

# yet acted on this object. If nil or empty, this object has been completely

882

# initialized. Otherwise, the object is considered uninitialized and is

883

# hidden (in list/watch and get calls) from clients that haven't explicitly

884

# asked to observe uninitialized objects.

885

#

886

# When an object is created, the system will populate this list with the

887

# current set of initializers. Only privileged users may set or modify this

888

# list. Once it is empty, it may not be modified further by any user.

889

"pending": [ # Pending is a list of initializers that must execute in order before this

890

# object is visible. When the last pending initializer is removed, and no

891

# failing result is set, the initializers struct will be set to nil and the

892

# object is considered as initialized and visible to all clients.

893

# +patchMergeKey=name

894

# +patchStrategy=merge

895

{ # Initializer is information about an initializer that has not yet completed.

896

"name": "A String", # name of the process that is responsible for initializing this object.

},

],

},

"resourceVersion": "A String", # An opaque value that represents the internal version of this object that

901

# can be used by clients to determine when objects have changed. May be used

902

# for optimistic concurrency, change detection, and the watch operation on a

903

# resource or set of resources. Clients must treat these values as opaque and

904

# passed unmodified back to the server. They may only be valid for a

905

# particular resource or set of resources.

906

#

907

# Populated by the system.

908

# Read-only.

909

# Value must be treated as opaque by clients and .

910

# More info:

911

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

912

# +optional

913

"generateName": "A String", # Not currently supported by Cloud Run.

914

#

915

# GenerateName is an optional prefix, used by the server, to generate a

916

# unique name ONLY IF the Name field has not been provided. If this field is

917

# used, the name returned to the client will be different than the name

918

# passed. This value will also be combined with a unique suffix. The provided

919

# value has the same validation rules as the Name field, and may be truncated

920

# by the length of the suffix required to make the value unique on the

921

# server.

922

#

923

# If this field is specified and the generated name exists, the server will

924

# NOT return a 409 - instead, it will either return 201 Created or 500 with

925

# Reason ServerTimeout indicating a unique name could not be found in the

926

# time allotted, and the client should retry (optionally after the time

927

# indicated in the Retry-After header).

928

#

929

# Applied only if Name is not specified.

930

# More info:

931

# https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency

932

# +optional

933

# string generateName = 2;

934

"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this

935

# object was created. It is not guaranteed to be set in happens-before order

936

# across separate operations. Clients may not set this value. It is

937

# represented in RFC3339 form and is in UTC.

938

#

939

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

944

# +optional

945

"annotations": { # Annotations is an unstructured key value map stored with a resource that

946

# may be set by external tools to store and retrieve arbitrary metadata. They

947

# are not queryable and should be preserved when modifying objects. More

948

# info: http://kubernetes.io/docs/user-guide/annotations +optional

949

"a_key": "A String",

950

},

951

"selfLink": "A String", # SelfLink is a URL representing this object.

952

# Populated by the system.

953

# Read-only.

954

# +optional

955

# string selfLink = 4;

956

"uid": "A String", # UID is the unique in time and space value for this object. It is typically

957

# generated by the server on successful creation of a resource and is not

958

# allowed to change on PUT operations.

959

#

960

# Populated by the system.

961

# Read-only.

962

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

# +optional

},

}</pre>

</div>

<code class="details" id="list">list(parent, labelSelector=None, includeUninitialized=None, x__xgafv=None, resourceVersion=None, limit=None, watch=None, continue=None, fieldSelector=None)</code>

970

<pre>Rpc to list triggers.

971

972

Args:

973

parent: string, The project ID or project number from which the triggers should

974

be listed. (required)

975

labelSelector: string, Allows to filter resources based on a label. Supported operations are

976

=, !=, exists, in, and notIn.

977

includeUninitialized: boolean, Not currently used by Cloud Run.

978

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

resourceVersion: string, The baseline resource version from which the list or watch operation should

983

start. Not currently used by Cloud Run.

984

limit: integer, The maximum number of records that should be returned.

985

watch: boolean, Flag that indicates that the client expects to watch this resource as well.

986

Not currently used by Cloud Run.

987

continue: string, Optional encoded string to continue paging.

988

fieldSelector: string, Allows to filter resources based on a specific value for a field name.

989

Send this in a query string format. i.e. 'metadata.name%3Dlorem'.

990

Not currently used by Cloud Run.

991

992

Returns:

993

An object of the form:

994

995

{ # ListTriggersResponse is a list of Trigger resources.

996

"unreachable": [ # Locations that could not be reached.

997

"A String",

998

],

999

"kind": "A String", # The kind of this resource, in this case "TriggerList".

1000

"items": [ # List of Triggers.

1001

{

1002

"status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of

1003

# date.

1004

# +optional

1005

"observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that

1006

# was last processed by the controller.

1007

"conditions": [ # Array of observed TriggerConditions, indicating the current state

1008

# of the Trigger.

1009

{ # TriggerCondition contains state information for an Trigger.

1010

"status": "A String", # Status of the condition, one of True, False, Unknown.

1011

"severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info

1012

# +optional

1013

"lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.

1014

# +optional

1015

"reason": "A String", # One-word CamelCase reason for the condition's current status.

1016

# +optional

1017

"message": "A String", # Human readable message indicating details about the current status.

1018

# +optional

1019

"type": "A String", # Type of Trigger condition.

1020

},

1021

],

1022

"subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger.

1023

},

1024

"kind": "A String", # The kind of resource, in this case "Trigger".

1025

"spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger.

1026

"filter": { # Filter is the filter to apply against all events from the Broker. Only

1027

# events that pass this filter will be sent to the Subscriber. If not

1028

# specified, will default to allowing all events.

1029

#

1030

# This must be specified in Cloud Run.

1031

"sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud

1032

# event's type and source attributes. Only exact matches will pass the filter.

1033

"source": "A String",

"type": "A String",

},

},

"subscriber": { # Subscriber is the addressable that receives events from the Broker that

1038

# pass the Filter. It is required.

1039

#

1040

# E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or

1041

# /namespaces/my-project/services/my-service.

1042

"ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target

1043

# endpoint, which should implement the Addressable duck type.

1044

# For example, this could be a reference to a Route resource

1045

# or a Knative Service resource.

1046

# referred object.

1047

"kind": "A String", # Kind of the referent.

1048

# More info:

1049

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

1050

# +optional

1051

"uid": "A String", # UID of the referent.

1052

# More info:

1053

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

1054

# +optional

1055

"namespace": "A String", # Namespace of the referent.

1056

# More info:

1057

# https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

1058

# +optional

1059

"apiVersion": "A String", # API version of the referent.

1060

# +optional

1061

"fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this

1062

# string should contain a valid JSON/Go field access statement, such as

1063

# desiredState.manifest.containers[2]. For example, if the object reference

1064

# is to a container within a pod, this would take on a value like:

1065

# "spec.containers{name}" (where "name" refers to the name of the container

1066

# that triggered the event) or if no container name is specified

1067

# "spec.containers[2]" (container with index 2 in this pod). This syntax is

1068

# chosen only to have some well-defined way of referencing a part of an

1069

# object.

1070

"resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any.

1071

# More info:

1072

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

1073

# +optional

1074

"name": "A String", # Name of the referent.

1075

# More info:

1076

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

1077

# +optional

1078

},

1079

"uri": "A String", # Reference to a 'known' endpoint where no resolving is done.

1080

# http://k8s-service for example

1081

# http://myexternalhandler.example.com/foo/bar

1082

},

1083

"broker": "A String", # Broker is the broker that this trigger receives events from. If not

1084

# specified, will default to 'default'.

1085

#

1086

# Not currently supported by Cloud Run.

1087

},

1088

"apiVersion": "A String", # The API version for this call such as "v1alpha1".

1089

"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger.

1090

# all objects users must create.

1091

"ownerReferences": [ # List of objects that own this object. If ALL objects in the list have

1092

# been deleted, this object will be garbage collected.

1093

# +optional

1094

{ # OwnerReference contains enough information to let you identify an owning

1095

# object. Currently, an owning object must be in the same namespace, so there

1096

# is no namespace field.

1097

"kind": "A String", # Kind of the referent.

1098

# More info:

1099

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

1100

"uid": "A String", # UID of the referent.

1101

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

1102

"apiVersion": "A String", # API version of the referent.

1103

"controller": True or False, # If true, this reference points to the managing controller.

1104

# +optional

1105

"blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then

1106

# the owner cannot be deleted from the key-value store until this

1107

# reference is removed.

1108

# Defaults to false.

1109

# To set this field, a user needs "delete" permission of the owner,

1110

# otherwise 422 (Unprocessable Entity) will be returned.

1111

# +optional

1112

"name": "A String", # Name of the referent.

1113

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

1114

},

1115

],

1116

"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.

1117

# Is required when creating

1118

# resources, although some resources may allow a client to request the

1119

# generation of an appropriate name automatically. Name is primarily intended

1120

# for creation idempotence and configuration definition. Cannot be updated.

1121

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

1122

# +optional

1123

"deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be

1124

# deleted. This field is set by the server when a graceful deletion is

1125

# requested by the user, and is not directly settable by a client. The

1126

# resource is expected to be deleted (no longer visible from resource lists,

1127

# and not reachable by name) after the time in this field, once the

1128

# finalizers list is empty. As long as the finalizers list contains items,

1129

# deletion is blocked. Once the deletionTimestamp is set, this value may not

1130

# be unset or be set further into the future, although it may be shortened or

1131

# the resource may be deleted prior to this time. For example, a user may

1132

# request that a pod is deleted in 30 seconds. The Kubelet will react by

1133

# sending a graceful termination signal to the containers in the pod. After

1134

# that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)

1135

# to the container and after cleanup, remove the pod from the API. In the

1136

# presence of network partitions, this object may still exist after this

1137

# timestamp, until an administrator or automated process can determine the

1138

# resource is fully terminated.

1139

# If not set, graceful deletion of the object has not been requested.

1140

#

1141

# Populated by the system when a graceful deletion is requested.

1142

# Read-only.

1143

# More info:

1144

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

1145

# +optional

1146

"clusterName": "A String", # Not currently supported by Cloud Run.

1147

#

1148

# The name of the cluster which the object belongs to.

1149

# This is used to distinguish resources with same name and namespace in

1150

# different clusters. This field is not set anywhere right now and apiserver

1151

# is going to ignore it if set in create or update request. +optional

1152

"deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.

1153

#

1154

# Number of seconds allowed for this object to gracefully terminate before

1155

# it will be removed from the system. Only set when deletionTimestamp is also

1156

# set. May only be shortened. Read-only. +optional

1157

"labels": { # Map of string keys and values that can be used to organize and categorize

1158

# (scope and select) objects. May match selectors of replication controllers

1159

# and routes.

1160

# More info: http://kubernetes.io/docs/user-guide/labels

# +optional

"a_key": "A String",

},

"namespace": "A String", # Namespace defines the space within each name must be unique, within a

1165

# Cloud Run region. In Cloud Run the namespace must be equal to either the

1166

# project ID or project number.

1167

"generation": 42, # A sequence number representing a specific generation of the desired state.

1168

# Populated by the system. Read-only.

1169

# +optional

1170

"finalizers": [ # Not currently supported by Cloud Run.

1171

#

1172

# Must be empty before the object is deleted from the registry. Each entry

1173

# is an identifier for the responsible component that will remove the entry

1174

# from the list. If the deletionTimestamp of the object is non-nil, entries

1175

# in this list can only be removed.

1176

# +optional

1177

# +patchStrategy=merge

1178

"A String",

1179

],

1180

"initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.

1181

#

1182

# An initializer is a controller which enforces some system invariant at

1183

# object creation time. This field is a list of initializers that have not

1184

# yet acted on this object. If nil or empty, this object has been completely

1185

# initialized. Otherwise, the object is considered uninitialized and is

1186

# hidden (in list/watch and get calls) from clients that haven't explicitly

1187

# asked to observe uninitialized objects.

1188

#

1189

# When an object is created, the system will populate this list with the

1190

# current set of initializers. Only privileged users may set or modify this

1191

# list. Once it is empty, it may not be modified further by any user.

1192

"pending": [ # Pending is a list of initializers that must execute in order before this

1193

# object is visible. When the last pending initializer is removed, and no

1194

# failing result is set, the initializers struct will be set to nil and the

1195

# object is considered as initialized and visible to all clients.

1196

# +patchMergeKey=name

1197

# +patchStrategy=merge

1198

{ # Initializer is information about an initializer that has not yet completed.

1199

"name": "A String", # name of the process that is responsible for initializing this object.

},

],

},

"resourceVersion": "A String", # An opaque value that represents the internal version of this object that

1204

# can be used by clients to determine when objects have changed. May be used

1205

# for optimistic concurrency, change detection, and the watch operation on a

1206

# resource or set of resources. Clients must treat these values as opaque and

1207

# passed unmodified back to the server. They may only be valid for a

1208

# particular resource or set of resources.

1209

#

1210

# Populated by the system.

1211

# Read-only.

1212

# Value must be treated as opaque by clients and .

1213

# More info:

1214

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

1215

# +optional

1216

"generateName": "A String", # Not currently supported by Cloud Run.

1217

#

1218

# GenerateName is an optional prefix, used by the server, to generate a

1219

# unique name ONLY IF the Name field has not been provided. If this field is

1220

# used, the name returned to the client will be different than the name

1221

# passed. This value will also be combined with a unique suffix. The provided

1222

# value has the same validation rules as the Name field, and may be truncated

1223

# by the length of the suffix required to make the value unique on the

1224

# server.

1225

#

1226

# If this field is specified and the generated name exists, the server will

1227

# NOT return a 409 - instead, it will either return 201 Created or 500 with

1228

# Reason ServerTimeout indicating a unique name could not be found in the

1229

# time allotted, and the client should retry (optionally after the time

1230

# indicated in the Retry-After header).

1231

#

1232

# Applied only if Name is not specified.

1233

# More info:

1234

# https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency

1235

# +optional

1236

# string generateName = 2;

1237

"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this

1238

# object was created. It is not guaranteed to be set in happens-before order

1239

# across separate operations. Clients may not set this value. It is

1240

# represented in RFC3339 form and is in UTC.

1241

#

1242

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

1247

# +optional

1248

"annotations": { # Annotations is an unstructured key value map stored with a resource that

1249

# may be set by external tools to store and retrieve arbitrary metadata. They

1250

# are not queryable and should be preserved when modifying objects. More

1251

# info: http://kubernetes.io/docs/user-guide/annotations +optional

1252

"a_key": "A String",

1253

},

1254

"selfLink": "A String", # SelfLink is a URL representing this object.

1255

# Populated by the system.

1256

# Read-only.

1257

# +optional

1258

# string selfLink = 4;

1259

"uid": "A String", # UID is the unique in time and space value for this object. It is typically

1260

# generated by the server on successful creation of a resource and is not

1261

# allowed to change on PUT operations.

1262

#

1263

# Populated by the system.

1264

# Read-only.

1265

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

# +optional

},

},

],

"apiVersion": "A String", # The API version for this call such as "v1alpha1".

1271

"metadata": { # ListMeta describes metadata that synthetic resources must have, including # Metadata associated with this Trigger list.

1272

# lists and various status objects. A resource may have only one of

1273

# {ObjectMeta, ListMeta}.

1274

"continue": "A String", # continue may be set if the user set a limit on the number of items

1275

# returned, and indicates that the server has more data available. The value

1276

# is opaque and may be used to issue another request to the endpoint that

1277

# served this list to retrieve the next set of available objects. Continuing

1278

# a list may not be possible if the server configuration has changed or more

1279

# than a few minutes have passed. The resourceVersion field returned when

1280

# using this continue value will be identical to the value in the first

1281

# response.

1282

"selfLink": "A String", # SelfLink is a URL representing this object.

1283

# Populated by the system.

1284

# Read-only.

1285

# +optional

1286

"resourceVersion": "A String", # String that identifies the server's internal version of this object that

1287

# can be used by clients to determine when objects have changed. Value must

1288

# be treated as opaque by clients and passed unmodified back to the server.

1289

# Populated by the system.

1290

# Read-only.

1291

# More info:

1292

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

# +optional

},

}</pre>

</div>

<code class="details" id="replaceTrigger">replaceTrigger(name, body, x__xgafv=None)</code>

1300

<pre>Rpc to replace a trigger.

1301

1302

Only the spec and metadata labels and annotations are modifiable. After

1303

the Update request, Cloud Run will work to make the 'status'

1304

match the requested 'spec'.

1305

1306

May provide metadata.resourceVersion to enforce update from last read for

1307

optimistic concurrency control.

Args:

{namespace_id} with the project ID. (required)

1312

body: object, The request body. (required)

1313

The object takes the form of:

1314

1315

{

1316

"status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of

1317

# date.

1318

# +optional

1319

"observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that

1320

# was last processed by the controller.

1321

"conditions": [ # Array of observed TriggerConditions, indicating the current state

1322

# of the Trigger.

1323

{ # TriggerCondition contains state information for an Trigger.

1324

"status": "A String", # Status of the condition, one of True, False, Unknown.

1325

"severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info

1326

# +optional

1327

"lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.

1328

# +optional

1329

"reason": "A String", # One-word CamelCase reason for the condition's current status.

1330

# +optional

1331

"message": "A String", # Human readable message indicating details about the current status.

1332

# +optional

1333

"type": "A String", # Type of Trigger condition.

1334

},

1335

],

1336

"subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger.

1337

},

1338

"kind": "A String", # The kind of resource, in this case "Trigger".

1339

"spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger.

1340

"filter": { # Filter is the filter to apply against all events from the Broker. Only

1341

# events that pass this filter will be sent to the Subscriber. If not

1342

# specified, will default to allowing all events.

1343

#

1344

# This must be specified in Cloud Run.

1345

"sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud

1346

# event's type and source attributes. Only exact matches will pass the filter.

1347

"source": "A String",

"type": "A String",

},

},

"subscriber": { # Subscriber is the addressable that receives events from the Broker that

1352

# pass the Filter. It is required.

1353

#

1354

# E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or

1355

# /namespaces/my-project/services/my-service.

1356

"ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target

1357

# endpoint, which should implement the Addressable duck type.

1358

# For example, this could be a reference to a Route resource

1359

# or a Knative Service resource.

1360

# referred object.

1361

"kind": "A String", # Kind of the referent.

1362

# More info:

1363

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

1364

# +optional

1365

"uid": "A String", # UID of the referent.

1366

# More info:

1367

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

1368

# +optional

1369

"namespace": "A String", # Namespace of the referent.

1370

# More info:

1371

# https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

1372

# +optional

1373

"apiVersion": "A String", # API version of the referent.

1374

# +optional

1375

"fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this

1376

# string should contain a valid JSON/Go field access statement, such as

1377

# desiredState.manifest.containers[2]. For example, if the object reference

1378

# is to a container within a pod, this would take on a value like:

1379

# "spec.containers{name}" (where "name" refers to the name of the container

1380

# that triggered the event) or if no container name is specified

1381

# "spec.containers[2]" (container with index 2 in this pod). This syntax is

1382

# chosen only to have some well-defined way of referencing a part of an

1383

# object.

1384

"resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any.

1385

# More info:

1386

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

1387

# +optional

1388

"name": "A String", # Name of the referent.

1389

# More info:

1390

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

1391

# +optional

1392

},

1393

"uri": "A String", # Reference to a 'known' endpoint where no resolving is done.

1394

# http://k8s-service for example

1395

# http://myexternalhandler.example.com/foo/bar

1396

},

1397

"broker": "A String", # Broker is the broker that this trigger receives events from. If not

1398

# specified, will default to 'default'.

1399

#

1400

# Not currently supported by Cloud Run.

1401

},

1402

"apiVersion": "A String", # The API version for this call such as "v1alpha1".

1403

"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger.

1404

# all objects users must create.

1405

"ownerReferences": [ # List of objects that own this object. If ALL objects in the list have

1406

# been deleted, this object will be garbage collected.

1407

# +optional

1408

{ # OwnerReference contains enough information to let you identify an owning

1409

# object. Currently, an owning object must be in the same namespace, so there

1410

# is no namespace field.

1411

"kind": "A String", # Kind of the referent.

1412

# More info:

1413

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

1414

"uid": "A String", # UID of the referent.

1415

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

1416

"apiVersion": "A String", # API version of the referent.

1417

"controller": True or False, # If true, this reference points to the managing controller.

1418

# +optional

1419

"blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then

1420

# the owner cannot be deleted from the key-value store until this

1421

# reference is removed.

1422

# Defaults to false.

1423

# To set this field, a user needs "delete" permission of the owner,

1424

# otherwise 422 (Unprocessable Entity) will be returned.

1425

# +optional

1426

"name": "A String", # Name of the referent.

1427

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

1428

},

1429

],

1430

"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.

1431

# Is required when creating

1432

# resources, although some resources may allow a client to request the

1433

# generation of an appropriate name automatically. Name is primarily intended

1434

# for creation idempotence and configuration definition. Cannot be updated.

1435

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

1436

# +optional

1437

"deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be

1438

# deleted. This field is set by the server when a graceful deletion is

1439

# requested by the user, and is not directly settable by a client. The

1440

# resource is expected to be deleted (no longer visible from resource lists,

1441

# and not reachable by name) after the time in this field, once the

1442

# finalizers list is empty. As long as the finalizers list contains items,

1443

# deletion is blocked. Once the deletionTimestamp is set, this value may not

1444

# be unset or be set further into the future, although it may be shortened or

1445

# the resource may be deleted prior to this time. For example, a user may

1446

# request that a pod is deleted in 30 seconds. The Kubelet will react by

1447

# sending a graceful termination signal to the containers in the pod. After

1448

# that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)

1449

# to the container and after cleanup, remove the pod from the API. In the

1450

# presence of network partitions, this object may still exist after this

1451

# timestamp, until an administrator or automated process can determine the

1452

# resource is fully terminated.

1453

# If not set, graceful deletion of the object has not been requested.

1454

#

1455

# Populated by the system when a graceful deletion is requested.

1456

# Read-only.

1457

# More info:

1458

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

1459

# +optional

1460

"clusterName": "A String", # Not currently supported by Cloud Run.

1461

#

1462

# The name of the cluster which the object belongs to.

1463

# This is used to distinguish resources with same name and namespace in

1464

# different clusters. This field is not set anywhere right now and apiserver

1465

# is going to ignore it if set in create or update request. +optional

1466

"deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.

1467

#

1468

# Number of seconds allowed for this object to gracefully terminate before

1469

# it will be removed from the system. Only set when deletionTimestamp is also

1470

# set. May only be shortened. Read-only. +optional

1471

"labels": { # Map of string keys and values that can be used to organize and categorize

1472

# (scope and select) objects. May match selectors of replication controllers

1473

# and routes.

1474

# More info: http://kubernetes.io/docs/user-guide/labels

# +optional

"a_key": "A String",

},

"namespace": "A String", # Namespace defines the space within each name must be unique, within a

1479

# Cloud Run region. In Cloud Run the namespace must be equal to either the

1480

# project ID or project number.

1481

"generation": 42, # A sequence number representing a specific generation of the desired state.

1482

# Populated by the system. Read-only.

1483

# +optional

1484

"finalizers": [ # Not currently supported by Cloud Run.

1485

#

1486

# Must be empty before the object is deleted from the registry. Each entry

1487

# is an identifier for the responsible component that will remove the entry

1488

# from the list. If the deletionTimestamp of the object is non-nil, entries

1489

# in this list can only be removed.

1490

# +optional

1491

# +patchStrategy=merge

1492

"A String",

1493

],

1494

"initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.

1495

#

1496

# An initializer is a controller which enforces some system invariant at

1497

# object creation time. This field is a list of initializers that have not

1498

# yet acted on this object. If nil or empty, this object has been completely

1499

# initialized. Otherwise, the object is considered uninitialized and is

1500

# hidden (in list/watch and get calls) from clients that haven't explicitly

1501

# asked to observe uninitialized objects.

1502

#

1503

# When an object is created, the system will populate this list with the

1504

# current set of initializers. Only privileged users may set or modify this

1505

# list. Once it is empty, it may not be modified further by any user.

1506

"pending": [ # Pending is a list of initializers that must execute in order before this

1507

# object is visible. When the last pending initializer is removed, and no

1508

# failing result is set, the initializers struct will be set to nil and the

1509

# object is considered as initialized and visible to all clients.

1510

# +patchMergeKey=name

1511

# +patchStrategy=merge

1512

{ # Initializer is information about an initializer that has not yet completed.

1513

"name": "A String", # name of the process that is responsible for initializing this object.

},

],

},

"resourceVersion": "A String", # An opaque value that represents the internal version of this object that

1518

# can be used by clients to determine when objects have changed. May be used

1519

# for optimistic concurrency, change detection, and the watch operation on a

1520

# resource or set of resources. Clients must treat these values as opaque and

1521

# passed unmodified back to the server. They may only be valid for a

1522

# particular resource or set of resources.

1523

#

1524

# Populated by the system.

1525

# Read-only.

1526

# Value must be treated as opaque by clients and .

1527

# More info:

1528

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

1529

# +optional

1530

"generateName": "A String", # Not currently supported by Cloud Run.

1531

#

1532

# GenerateName is an optional prefix, used by the server, to generate a

1533

# unique name ONLY IF the Name field has not been provided. If this field is

1534

# used, the name returned to the client will be different than the name

1535

# passed. This value will also be combined with a unique suffix. The provided

1536

# value has the same validation rules as the Name field, and may be truncated

1537

# by the length of the suffix required to make the value unique on the

1538

# server.

1539

#

1540

# If this field is specified and the generated name exists, the server will

1541

# NOT return a 409 - instead, it will either return 201 Created or 500 with

1542

# Reason ServerTimeout indicating a unique name could not be found in the

1543

# time allotted, and the client should retry (optionally after the time

1544

# indicated in the Retry-After header).

1545

#

1546

# Applied only if Name is not specified.

1547

# More info:

1548

# https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency

1549

# +optional

1550

# string generateName = 2;

1551

"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this

1552

# object was created. It is not guaranteed to be set in happens-before order

1553

# across separate operations. Clients may not set this value. It is

1554

# represented in RFC3339 form and is in UTC.

1555

#

1556

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

1561

# +optional

1562

"annotations": { # Annotations is an unstructured key value map stored with a resource that

1563

# may be set by external tools to store and retrieve arbitrary metadata. They

1564

# are not queryable and should be preserved when modifying objects. More

1565

# info: http://kubernetes.io/docs/user-guide/annotations +optional

1566

"a_key": "A String",

1567

},

1568

"selfLink": "A String", # SelfLink is a URL representing this object.

1569

# Populated by the system.

1570

# Read-only.

1571

# +optional

1572

# string selfLink = 4;

1573

"uid": "A String", # UID is the unique in time and space value for this object. It is typically

1574

# generated by the server on successful creation of a resource and is not

1575

# allowed to change on PUT operations.

1576

#

1577

# Populated by the system.

1578

# Read-only.

1579

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

# +optional

},

}

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

1591

1592

{

1593

"status": { # TriggerStatus represents the current state of a Trigger. # Status represents the current state of the Trigger. This data may be out of

1594

# date.

1595

# +optional

1596

"observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Trigger that

1597

# was last processed by the controller.

1598

"conditions": [ # Array of observed TriggerConditions, indicating the current state

1599

# of the Trigger.

1600

{ # TriggerCondition contains state information for an Trigger.

1601

"status": "A String", # Status of the condition, one of True, False, Unknown.

1602

"severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info

1603

# +optional

1604

"lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.

1605

# +optional

1606

"reason": "A String", # One-word CamelCase reason for the condition's current status.

1607

# +optional

1608

"message": "A String", # Human readable message indicating details about the current status.

1609

# +optional

1610

"type": "A String", # Type of Trigger condition.

1611

},

1612

],

1613

"subscriberUri": "A String", # SubscriberURI is the resolved URI of the receiver for this Trigger.

1614

},

1615

"kind": "A String", # The kind of resource, in this case "Trigger".

1616

"spec": { # The desired state of the Trigger. # Spec defines the desired state of the Trigger.

1617

"filter": { # Filter is the filter to apply against all events from the Broker. Only

1618

# events that pass this filter will be sent to the Subscriber. If not

1619

# specified, will default to allowing all events.

1620

#

1621

# This must be specified in Cloud Run.

1622

"sourceAndType": { # TriggerFilterSourceAndType filters events based on exact matches on the cloud

1623

# event's type and source attributes. Only exact matches will pass the filter.

1624

"source": "A String",

"type": "A String",

},

},

"subscriber": { # Subscriber is the addressable that receives events from the Broker that

1629

# pass the Filter. It is required.

1630

#

1631

# E.g. https://us-central1-myproject.cloudfunctions.net/myfunction or

1632

# /namespaces/my-project/services/my-service.

1633

"ref": { # ObjectReference contains enough information to let you inspect or modify the # Reference to an object that will be used to find the target

1634

# endpoint, which should implement the Addressable duck type.

1635

# For example, this could be a reference to a Route resource

1636

# or a Knative Service resource.

1637

# referred object.

1638

"kind": "A String", # Kind of the referent.

1639

# More info:

1640

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

1641

# +optional

1642

"uid": "A String", # UID of the referent.

1643

# More info:

1644

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

1645

# +optional

1646

"namespace": "A String", # Namespace of the referent.

1647

# More info:

1648

# https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

1649

# +optional

1650

"apiVersion": "A String", # API version of the referent.

1651

# +optional

1652

"fieldPath": "A String", # If referring to a piece of an object instead of an entire object, this

1653

# string should contain a valid JSON/Go field access statement, such as

1654

# desiredState.manifest.containers[2]. For example, if the object reference

1655

# is to a container within a pod, this would take on a value like:

1656

# "spec.containers{name}" (where "name" refers to the name of the container

1657

# that triggered the event) or if no container name is specified

1658

# "spec.containers[2]" (container with index 2 in this pod). This syntax is

1659

# chosen only to have some well-defined way of referencing a part of an

1660

# object.

1661

"resourceVersion": "A String", # Specific resourceVersion to which this reference is made, if any.

1662

# More info:

1663

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

1664

# +optional

1665

"name": "A String", # Name of the referent.

1666

# More info:

1667

# https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

1668

# +optional

1669

},

1670

"uri": "A String", # Reference to a 'known' endpoint where no resolving is done.

1671

# http://k8s-service for example

1672

# http://myexternalhandler.example.com/foo/bar

1673

},

1674

"broker": "A String", # Broker is the broker that this trigger receives events from. If not

1675

# specified, will default to 'default'.

1676

#

1677

# Not currently supported by Cloud Run.

1678

},

1679

"apiVersion": "A String", # The API version for this call such as "v1alpha1".

1680

"metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Trigger.

1681

# all objects users must create.

1682

"ownerReferences": [ # List of objects that own this object. If ALL objects in the list have

1683

# been deleted, this object will be garbage collected.

1684

# +optional

1685

{ # OwnerReference contains enough information to let you identify an owning

1686

# object. Currently, an owning object must be in the same namespace, so there

1687

# is no namespace field.

1688

"kind": "A String", # Kind of the referent.

1689

# More info:

1690

# https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

1691

"uid": "A String", # UID of the referent.

1692

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

1693

"apiVersion": "A String", # API version of the referent.

1694

"controller": True or False, # If true, this reference points to the managing controller.

1695

# +optional

1696

"blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then

1697

# the owner cannot be deleted from the key-value store until this

1698

# reference is removed.

1699

# Defaults to false.

1700

# To set this field, a user needs "delete" permission of the owner,

1701

# otherwise 422 (Unprocessable Entity) will be returned.

1702

# +optional

1703

"name": "A String", # Name of the referent.

1704

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

1705

},

1706

],

1707

"name": "A String", # Name must be unique within a namespace, within a Cloud Run region.

1708

# Is required when creating

1709

# resources, although some resources may allow a client to request the

1710

# generation of an appropriate name automatically. Name is primarily intended

1711

# for creation idempotence and configuration definition. Cannot be updated.

1712

# More info: http://kubernetes.io/docs/user-guide/identifiers#names

1713

# +optional

1714

"deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be

1715

# deleted. This field is set by the server when a graceful deletion is

1716

# requested by the user, and is not directly settable by a client. The

1717

# resource is expected to be deleted (no longer visible from resource lists,

1718

# and not reachable by name) after the time in this field, once the

1719

# finalizers list is empty. As long as the finalizers list contains items,

1720

# deletion is blocked. Once the deletionTimestamp is set, this value may not

1721

# be unset or be set further into the future, although it may be shortened or

1722

# the resource may be deleted prior to this time. For example, a user may

1723

# request that a pod is deleted in 30 seconds. The Kubelet will react by

1724

# sending a graceful termination signal to the containers in the pod. After

1725

# that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)

1726

# to the container and after cleanup, remove the pod from the API. In the

1727

# presence of network partitions, this object may still exist after this

1728

# timestamp, until an administrator or automated process can determine the

1729

# resource is fully terminated.

1730

# If not set, graceful deletion of the object has not been requested.

1731

#

1732

# Populated by the system when a graceful deletion is requested.

1733

# Read-only.

1734

# More info:

1735

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

1736

# +optional

1737

"clusterName": "A String", # Not currently supported by Cloud Run.

1738

#

1739

# The name of the cluster which the object belongs to.

1740

# This is used to distinguish resources with same name and namespace in

1741

# different clusters. This field is not set anywhere right now and apiserver

1742

# is going to ignore it if set in create or update request. +optional

1743

"deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.

1744

#

1745

# Number of seconds allowed for this object to gracefully terminate before

1746

# it will be removed from the system. Only set when deletionTimestamp is also

1747

# set. May only be shortened. Read-only. +optional

1748

"labels": { # Map of string keys and values that can be used to organize and categorize

1749

# (scope and select) objects. May match selectors of replication controllers

1750

# and routes.

1751

# More info: http://kubernetes.io/docs/user-guide/labels

# +optional

"a_key": "A String",

},

"namespace": "A String", # Namespace defines the space within each name must be unique, within a

1756

# Cloud Run region. In Cloud Run the namespace must be equal to either the

1757

# project ID or project number.

1758

"generation": 42, # A sequence number representing a specific generation of the desired state.

1759

# Populated by the system. Read-only.

1760

# +optional

1761

"finalizers": [ # Not currently supported by Cloud Run.

1762

#

1763

# Must be empty before the object is deleted from the registry. Each entry

1764

# is an identifier for the responsible component that will remove the entry

1765

# from the list. If the deletionTimestamp of the object is non-nil, entries

1766

# in this list can only be removed.

1767

# +optional

1768

# +patchStrategy=merge

1769

"A String",

1770

],

1771

"initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.

1772

#

1773

# An initializer is a controller which enforces some system invariant at

1774

# object creation time. This field is a list of initializers that have not

1775

# yet acted on this object. If nil or empty, this object has been completely

1776

# initialized. Otherwise, the object is considered uninitialized and is

1777

# hidden (in list/watch and get calls) from clients that haven't explicitly

1778

# asked to observe uninitialized objects.

1779

#

1780

# When an object is created, the system will populate this list with the

1781

# current set of initializers. Only privileged users may set or modify this

1782

# list. Once it is empty, it may not be modified further by any user.

1783

"pending": [ # Pending is a list of initializers that must execute in order before this

1784

# object is visible. When the last pending initializer is removed, and no

1785

# failing result is set, the initializers struct will be set to nil and the

1786

# object is considered as initialized and visible to all clients.

1787

# +patchMergeKey=name

1788

# +patchStrategy=merge

1789

{ # Initializer is information about an initializer that has not yet completed.

1790

"name": "A String", # name of the process that is responsible for initializing this object.

},

],

},

"resourceVersion": "A String", # An opaque value that represents the internal version of this object that

1795

# can be used by clients to determine when objects have changed. May be used

1796

# for optimistic concurrency, change detection, and the watch operation on a

1797

# resource or set of resources. Clients must treat these values as opaque and

1798

# passed unmodified back to the server. They may only be valid for a

1799

# particular resource or set of resources.

1800

#

1801

# Populated by the system.

1802

# Read-only.

1803

# Value must be treated as opaque by clients and .

1804

# More info:

1805

# https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

1806

# +optional

1807

"generateName": "A String", # Not currently supported by Cloud Run.

1808

#

1809

# GenerateName is an optional prefix, used by the server, to generate a

1810

# unique name ONLY IF the Name field has not been provided. If this field is

1811

# used, the name returned to the client will be different than the name

1812

# passed. This value will also be combined with a unique suffix. The provided

1813

# value has the same validation rules as the Name field, and may be truncated

1814

# by the length of the suffix required to make the value unique on the

1815

# server.

1816

#

1817

# If this field is specified and the generated name exists, the server will

1818

# NOT return a 409 - instead, it will either return 201 Created or 500 with

1819

# Reason ServerTimeout indicating a unique name could not be found in the

1820

# time allotted, and the client should retry (optionally after the time

1821

# indicated in the Retry-After header).

1822

#

1823

# Applied only if Name is not specified.

1824

# More info:

1825

# https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency

1826

# +optional

1827

# string generateName = 2;

1828

"creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this

1829

# object was created. It is not guaranteed to be set in happens-before order

1830

# across separate operations. Clients may not set this value. It is

1831

# represented in RFC3339 form and is in UTC.

1832

#

1833

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

# https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

1838

# +optional

1839

"annotations": { # Annotations is an unstructured key value map stored with a resource that

1840

# may be set by external tools to store and retrieve arbitrary metadata. They

1841

# are not queryable and should be preserved when modifying objects. More

1842

# info: http://kubernetes.io/docs/user-guide/annotations +optional

1843

"a_key": "A String",

1844

},

1845

"selfLink": "A String", # SelfLink is a URL representing this object.

1846

# Populated by the system.

1847

# Read-only.

1848

# +optional

1849

# string selfLink = 4;

1850

"uid": "A String", # UID is the unique in time and space value for this object. It is typically

1851

# generated by the server on successful creation of a resource and is not

1852

# allowed to change on PUT operations.

1853

#

1854

# Populated by the system.

1855

# Read-only.

1856

# More info: http://kubernetes.io/docs/user-guide/identifiers#uids

# +optional

},

}</pre>

</div>

</body></html>