Blame - docs/dyn/run_v1alpha1.namespaces.cloudauditlogssources.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.cloudauditlogssources.html">cloudauditlogssources</a></h1>

76

<h2>Instance Methods</h2>

77

78

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

79

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

80

81

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

82

<p class="firstline">Rpc to delete a cloudauditlogssource.</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 cloudauditlogssource.</p>

86

87

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

88

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

89

<h3>Method Details</h3>

90

91

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

92

<pre>Creates a new cloudauditlogssource.

93

94

Args:

95

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

96

be created. (required)

97

body: object, The request body.

98

The object takes the form of:

99

100

{

101

"status": { # CloudAuditLogsSourceStatus represents the current state of a # Status represents the current state of the CloudAuditLogsSource. This data

102

# may be out of date. +optional

103

# CloudAuditLogsSource.

104

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

105

# was last processed by the controller.

106

"sinkUri": "A String", # SinkURI is the current active sink URI that has been configured for the

107

# Source.

108

# +optional

109

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

110

# state of the CloudAuditLogsSource.

111

{ # Condition defines a generic condition for a Resource

112

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

113

"reason": "A String", # Optional. One-word CamelCase reason for the condition's last transition.

114

"type": "A String", # type is used to communicate the status of the reconciliation process.

115

# See also:

116

# https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting

117

# Types common to all resources include:

118

# * "Ready": True when the Resource is ready.

119

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

120

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

121

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

},

],

},

"apiVersion": "A String", # The API version for this call such as "events.cloud.google.com/v1alpha1".

126

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

127

"resourceName": "A String", # Optional. The resource specification. This must match "methodName"

128

# in Cloud Audit Logs. Regex or Wildcards (*) are not supported.

129

# Example: "projects/my-project/jobs/foo".

130

"ceOverrides": { # CloudEventOverrides defines arguments for a Source that control the output # CloudEventOverrides defines overrides to control the output format and

131

# modifications of the event sent to the sink.

132

# +optional

133

# format of the CloudEvents produced by the Source.

134

"extensions": { # Extensions specify what attribute are added or overridden on the outbound

135

# event. Each `Extensions` key-value pair are set on the event as an

136

# attribute extension independently.

# +optional

"a_key": "A String",

},

},

"serviceAccountName": "A String", # Optional. Email address of the IAM service account associated with the source. The

142

# service account represents the identity of the source, and determines what

143

# permissions the source has. If not provided, the source will use the

144

# project's default service account.

145

"serviceName": "A String", # Required. The GCP service name. This must match "serviceName" in Cloud Audit Logs.

146

# Regex or Wildcards (*) are not supported.

147

# Example: "bigquery.googleapis.com".

148

"methodName": "A String", # Required. The method name at the service API. This must match "methodName" in Cloud

149

# Audit Logs. Regex or Wildcards (*) are not supported.

150

# Example: "google.cloud.bigquery.job.create".

151

"sink": { # Sink is a reference to an object that will resolve to a domain name or a

152

# URI directly to use as the sink.

153

"uri": "A String", # URI is for direct URI Designations or used with the resulting URL from

154

# Addressable ObjectReference. If used with an ObjectReference, will be

155

# appended to the path of the resulting URL from the Addressable.

156

# + optional

157

"ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.

158

# + optional

159

# referred object.

160

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

161

# +optional

162

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

163

# More info:

164

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

165

# +optional

166

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

167

# More info:

168

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

169

# +optional

170

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

171

# More info:

172

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

173

# +optional

174

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

175

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

176

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

177

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

178

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

179

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

180

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

181

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

182

# object.

183

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

184

# More info:

185

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

186

# +optional

187

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

188

# More info:

189

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

# +optional

},

},

},

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

195

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

196

# all objects users must create.

197

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

198

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

199

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

200

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

201

"a_key": "A String",

202

},

203

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

204

#

205

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

206

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

207

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

208

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

209

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

210

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

211

# server.

212

#

213

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

214

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

215

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

216

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

217

# indicated in the Retry-After header).

218

#

219

# Applied only if Name is not specified.

220

# More info:

221

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

222

# +optional

223

# string generateName = 2;

224

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

225

# Is required when creating

226

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

227

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

228

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

229

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

230

# +optional

231

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

232

#

233

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

234

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

235

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

236

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

237

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

238

#

239

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

240

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

241

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

242

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

243

#

244

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

245

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

246

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

247

# in this list can only be removed.

248

# +optional

249

# +patchStrategy=merge

250

"A String",

251

],

252

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

253

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

254

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

255

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

256

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

257

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

258

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

259

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

260

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

261

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

262

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

263

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

264

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

265

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

266

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

267

# resource is fully terminated.

268

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

269

#

270

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

271

# Read-only.

272

# More info:

273

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

274

# +optional

275

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

276

# been deleted, this object will be garbage collected.

277

# +optional

278

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

279

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

280

# is no namespace field.

281

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

282

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

283

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

284

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

285

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

286

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

287

# +optional

288

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

289

# More info:

290

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

291

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

292

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

293

# reference is removed.

294

# Defaults to false.

295

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

296

# otherwise 422 (Unprocessable Entity) will be returned.

# +optional

},

],

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

301

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

302

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

303

# represented in RFC3339 form and is in UTC.

304

#

305

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

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

310

# +optional

311

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

312

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

313

# and routes.

314

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

# +optional

"a_key": "A String",

},

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

319

# Populated by the system. Read-only.

320

# +optional

321

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

322

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

323

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

324

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

325

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

326

# particular resource or set of resources.

327

#

328

# Populated by the system.

329

# Read-only.

330

# Value must be treated as opaque by clients and .

331

# More info:

332

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

333

# +optional

334

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

335

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

336

# allowed to change on PUT operations.

337

#

338

# Populated by the system.

339

# Read-only.

340

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

341

# +optional

342

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

343

# Populated by the system.

344

# Read-only.

345

# +optional

346

# string selfLink = 4;

347

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

348

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

349

# project ID or project number.

},

}

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

360

361

{

362

"status": { # CloudAuditLogsSourceStatus represents the current state of a # Status represents the current state of the CloudAuditLogsSource. This data

363

# may be out of date. +optional

364

# CloudAuditLogsSource.

365

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

366

# was last processed by the controller.

367

"sinkUri": "A String", # SinkURI is the current active sink URI that has been configured for the

368

# Source.

369

# +optional

370

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

371

# state of the CloudAuditLogsSource.

372

{ # Condition defines a generic condition for a Resource

373

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

374

"reason": "A String", # Optional. One-word CamelCase reason for the condition's last transition.

375

"type": "A String", # type is used to communicate the status of the reconciliation process.

376

# See also:

377

# https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting

378

# Types common to all resources include:

379

# * "Ready": True when the Resource is ready.

380

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

381

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

382

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

},

],

},

"apiVersion": "A String", # The API version for this call such as "events.cloud.google.com/v1alpha1".

387

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

388

"resourceName": "A String", # Optional. The resource specification. This must match "methodName"

389

# in Cloud Audit Logs. Regex or Wildcards (*) are not supported.

390

# Example: "projects/my-project/jobs/foo".

391

"ceOverrides": { # CloudEventOverrides defines arguments for a Source that control the output # CloudEventOverrides defines overrides to control the output format and

392

# modifications of the event sent to the sink.

393

# +optional

394

# format of the CloudEvents produced by the Source.

395

"extensions": { # Extensions specify what attribute are added or overridden on the outbound

396

# event. Each `Extensions` key-value pair are set on the event as an

397

# attribute extension independently.

# +optional

"a_key": "A String",

},

},

"serviceAccountName": "A String", # Optional. Email address of the IAM service account associated with the source. The

403

# service account represents the identity of the source, and determines what

404

# permissions the source has. If not provided, the source will use the

405

# project's default service account.

406

"serviceName": "A String", # Required. The GCP service name. This must match "serviceName" in Cloud Audit Logs.

407

# Regex or Wildcards (*) are not supported.

408

# Example: "bigquery.googleapis.com".

409

"methodName": "A String", # Required. The method name at the service API. This must match "methodName" in Cloud

410

# Audit Logs. Regex or Wildcards (*) are not supported.

411

# Example: "google.cloud.bigquery.job.create".

412

"sink": { # Sink is a reference to an object that will resolve to a domain name or a

413

# URI directly to use as the sink.

414

"uri": "A String", # URI is for direct URI Designations or used with the resulting URL from

415

# Addressable ObjectReference. If used with an ObjectReference, will be

416

# appended to the path of the resulting URL from the Addressable.

417

# + optional

418

"ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.

419

# + optional

420

# referred object.

421

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

422

# +optional

423

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

424

# More info:

425

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

426

# +optional

427

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

428

# More info:

429

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

430

# +optional

431

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

432

# More info:

433

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

434

# +optional

435

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

436

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

437

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

438

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

439

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

440

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

441

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

442

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

443

# object.

444

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

445

# More info:

446

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

447

# +optional

448

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

449

# More info:

450

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

# +optional

},

},

},

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

456

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

457

# all objects users must create.

458

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

459

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

460

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

461

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

462

"a_key": "A String",

463

},

464

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

465

#

466

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

467

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

468

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

469

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

470

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

471

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

472

# server.

473

#

474

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

475

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

476

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

477

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

478

# indicated in the Retry-After header).

479

#

480

# Applied only if Name is not specified.

481

# More info:

482

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

483

# +optional

484

# string generateName = 2;

485

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

486

# Is required when creating

487

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

488

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

489

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

490

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

491

# +optional

492

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

493

#

494

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

495

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

496

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

497

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

498

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

499

#

500

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

501

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

502

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

503

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

504

#

505

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

506

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

507

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

508

# in this list can only be removed.

509

# +optional

510

# +patchStrategy=merge

511

"A String",

512

],

513

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

514

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

515

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

516

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

517

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

518

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

519

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

520

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

521

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

522

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

523

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

524

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

525

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

526

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

527

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

528

# resource is fully terminated.

529

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

530

#

531

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

532

# Read-only.

533

# More info:

534

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

535

# +optional

536

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

537

# been deleted, this object will be garbage collected.

538

# +optional

539

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

540

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

541

# is no namespace field.

542

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

543

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

544

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

545

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

546

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

547

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

548

# +optional

549

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

550

# More info:

551

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

552

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

553

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

554

# reference is removed.

555

# Defaults to false.

556

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

557

# otherwise 422 (Unprocessable Entity) will be returned.

# +optional

},

],

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

562

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

563

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

564

# represented in RFC3339 form and is in UTC.

565

#

566

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

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

571

# +optional

572

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

573

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

574

# and routes.

575

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

# +optional

"a_key": "A String",

},

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

580

# Populated by the system. Read-only.

581

# +optional

582

"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

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

596

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

597

# allowed to change on PUT operations.

598

#

599

# Populated by the system.

600

# Read-only.

601

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

602

# +optional

603

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

604

# Populated by the system.

605

# Read-only.

606

# +optional

607

# string selfLink = 4;

608

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

609

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

610

# project ID or project number.

},

}</pre>

</div>

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

617

<pre>Rpc to delete a cloudauditlogssource.

618

619

Args:

620

name: string, The name of the cloudauditlogssource being deleted. If needed, replace

621

{namespace_id} with the project ID. (required)

622

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

623

this setting, and deletes in the background. Please see

624

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

625

more information.

626

kind: string, Cloud Run currently ignores this parameter.

627

apiVersion: string, Cloud Run currently ignores this parameter.

628

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

635

636

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

637

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

638

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

639

#

640

# service Foo {

641

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

642

# }

643

#

644

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

}</pre>

</div>

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

650

<pre>Rpc to get information about a cloudauditlogssource.

651

652

Args:

653

name: string, The name of the cloudauditlogssource being retrieved. If needed, replace

654

{namespace_id} with the project ID. (required)

655

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

662

663

{

664

"status": { # CloudAuditLogsSourceStatus represents the current state of a # Status represents the current state of the CloudAuditLogsSource. This data

665

# may be out of date. +optional

666

# CloudAuditLogsSource.

667

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

668

# was last processed by the controller.

669

"sinkUri": "A String", # SinkURI is the current active sink URI that has been configured for the

670

# Source.

671

# +optional

672

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

673

# state of the CloudAuditLogsSource.

674

{ # Condition defines a generic condition for a Resource

675

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

676

"reason": "A String", # Optional. One-word CamelCase reason for the condition's last transition.

677

"type": "A String", # type is used to communicate the status of the reconciliation process.

678

# See also:

679

# https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting

680

# Types common to all resources include:

681

# * "Ready": True when the Resource is ready.

682

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

683

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

684

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

},

],

},

"apiVersion": "A String", # The API version for this call such as "events.cloud.google.com/v1alpha1".

689

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

690

"resourceName": "A String", # Optional. The resource specification. This must match "methodName"

691

# in Cloud Audit Logs. Regex or Wildcards (*) are not supported.

692

# Example: "projects/my-project/jobs/foo".

693

"ceOverrides": { # CloudEventOverrides defines arguments for a Source that control the output # CloudEventOverrides defines overrides to control the output format and

694

# modifications of the event sent to the sink.

695

# +optional

696

# format of the CloudEvents produced by the Source.

697

"extensions": { # Extensions specify what attribute are added or overridden on the outbound

698

# event. Each `Extensions` key-value pair are set on the event as an

699

# attribute extension independently.

# +optional

"a_key": "A String",

},

},

"serviceAccountName": "A String", # Optional. Email address of the IAM service account associated with the source. The

705

# service account represents the identity of the source, and determines what

706

# permissions the source has. If not provided, the source will use the

707

# project's default service account.

708

"serviceName": "A String", # Required. The GCP service name. This must match "serviceName" in Cloud Audit Logs.

709

# Regex or Wildcards (*) are not supported.

710

# Example: "bigquery.googleapis.com".

711

"methodName": "A String", # Required. The method name at the service API. This must match "methodName" in Cloud

712

# Audit Logs. Regex or Wildcards (*) are not supported.

713

# Example: "google.cloud.bigquery.job.create".

714

"sink": { # Sink is a reference to an object that will resolve to a domain name or a

715

# URI directly to use as the sink.

716

"uri": "A String", # URI is for direct URI Designations or used with the resulting URL from

717

# Addressable ObjectReference. If used with an ObjectReference, will be

718

# appended to the path of the resulting URL from the Addressable.

719

# + optional

720

"ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.

721

# + optional

722

# referred object.

723

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

724

# +optional

725

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

726

# More info:

727

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

728

# +optional

729

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

730

# More info:

731

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

732

# +optional

733

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

734

# More info:

735

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

736

# +optional

737

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

738

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

739

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

740

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

741

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

742

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

743

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

744

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

745

# object.

746

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

747

# More info:

748

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

749

# +optional

750

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

751

# More info:

752

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

# +optional

},

},

},

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

758

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

759

# all objects users must create.

760

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

761

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

762

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

763

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

764

"a_key": "A String",

765

},

766

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

767

#

768

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

769

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

770

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

771

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

772

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

773

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

774

# server.

775

#

776

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

777

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

778

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

779

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

780

# indicated in the Retry-After header).

781

#

782

# Applied only if Name is not specified.

783

# More info:

784

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

785

# +optional

786

# string generateName = 2;

787

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

788

# Is required when creating

789

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

790

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

791

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

792

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

793

# +optional

794

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

795

#

796

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

797

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

798

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

799

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

800

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

801

#

802

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

803

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

804

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

805

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

806

#

807

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

808

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

809

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

810

# in this list can only be removed.

811

# +optional

812

# +patchStrategy=merge

813

"A String",

814

],

815

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

816

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

817

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

818

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

819

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

820

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

821

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

822

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

823

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

824

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

825

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

826

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

827

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

828

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

829

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

830

# resource is fully terminated.

831

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

832

#

833

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

834

# Read-only.

835

# More info:

836

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

837

# +optional

838

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

839

# been deleted, this object will be garbage collected.

840

# +optional

841

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

842

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

843

# is no namespace field.

844

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

845

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

846

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

847

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

848

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

849

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

850

# +optional

851

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

852

# More info:

853

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

854

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

855

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

856

# reference is removed.

857

# Defaults to false.

858

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

859

# otherwise 422 (Unprocessable Entity) will be returned.

# +optional

},

],

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

864

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

865

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

866

# represented in RFC3339 form and is in UTC.

867

#

868

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

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

873

# +optional

874

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

875

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

876

# and routes.

877

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

# +optional

"a_key": "A String",

},

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

882

# Populated by the system. Read-only.

883

# +optional

884

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

885

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

886

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

887

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

888

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

889

# particular resource or set of resources.

890

#

891

# Populated by the system.

892

# Read-only.

893

# Value must be treated as opaque by clients and .

894

# More info:

895

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

896

# +optional

897

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

898

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

899

# allowed to change on PUT operations.

900

#

901

# Populated by the system.

902

# Read-only.

903

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

904

# +optional

905

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

906

# Populated by the system.

907

# Read-only.

908

# +optional

909

# string selfLink = 4;

910

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

911

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

912

# project ID or project number.

},

}</pre>

</div>

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

919

<pre>Rpc to list cloudauditlogssources.

920

921

Args:

922

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

923

should be listed. (required)

924

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

925

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

926

Not currently used by Cloud Run.

927

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

928

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

929

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

930

start. Not currently used by Cloud Run.

931

includeUninitialized: boolean, Not currently used by Cloud Run.

932

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

933

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

934

Not currently used by Cloud Run.

935

continue: string, Optional encoded string to continue paging.

936

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

943

944

{ # ListCloudAuditLogsSourcesResponse is a list of CloudAuditLogsSource

945

# resources.

946

"apiVersion": "A String", # The API version for this call such as "events.cloud.google.com/v1alpha1".

947

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

948

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

949

"A String",

950

],

951

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

952

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

953

# {ObjectMeta, ListMeta}.

954

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

955

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

956

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

957

# Populated by the system.

958

# Read-only.

959

# More info:

960

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

961

# +optional

962

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

963

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

964

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

965

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

966

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

967

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

968

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

969

# response.

970

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

971

# Populated by the system.

# Read-only.

# +optional

},

"items": [ # List of CloudAuditLogsSources.

976

{

977

"status": { # CloudAuditLogsSourceStatus represents the current state of a # Status represents the current state of the CloudAuditLogsSource. This data

978

# may be out of date. +optional

979

# CloudAuditLogsSource.

980

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

981

# was last processed by the controller.

982

"sinkUri": "A String", # SinkURI is the current active sink URI that has been configured for the

983

# Source.

984

# +optional

985

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

986

# state of the CloudAuditLogsSource.

987

{ # Condition defines a generic condition for a Resource

988

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

989

"reason": "A String", # Optional. One-word CamelCase reason for the condition's last transition.

990

"type": "A String", # type is used to communicate the status of the reconciliation process.

991

# See also:

992

# https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting

993

# Types common to all resources include:

994

# * "Ready": True when the Resource is ready.

995

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

996

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

997

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

},

],

},

"apiVersion": "A String", # The API version for this call such as "events.cloud.google.com/v1alpha1".

1002

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

1003

"resourceName": "A String", # Optional. The resource specification. This must match "methodName"

1004

# in Cloud Audit Logs. Regex or Wildcards (*) are not supported.

1005

# Example: "projects/my-project/jobs/foo".

1006

"ceOverrides": { # CloudEventOverrides defines arguments for a Source that control the output # CloudEventOverrides defines overrides to control the output format and

1007

# modifications of the event sent to the sink.

1008

# +optional

1009

# format of the CloudEvents produced by the Source.

1010

"extensions": { # Extensions specify what attribute are added or overridden on the outbound

1011

# event. Each `Extensions` key-value pair are set on the event as an

1012

# attribute extension independently.

# +optional

"a_key": "A String",

},

},

"serviceAccountName": "A String", # Optional. Email address of the IAM service account associated with the source. The

1018

# service account represents the identity of the source, and determines what

1019

# permissions the source has. If not provided, the source will use the

1020

# project's default service account.

1021

"serviceName": "A String", # Required. The GCP service name. This must match "serviceName" in Cloud Audit Logs.

1022

# Regex or Wildcards (*) are not supported.

1023

# Example: "bigquery.googleapis.com".

1024

"methodName": "A String", # Required. The method name at the service API. This must match "methodName" in Cloud

1025

# Audit Logs. Regex or Wildcards (*) are not supported.

1026

# Example: "google.cloud.bigquery.job.create".

1027

"sink": { # Sink is a reference to an object that will resolve to a domain name or a

1028

# URI directly to use as the sink.

1029

"uri": "A String", # URI is for direct URI Designations or used with the resulting URL from

1030

# Addressable ObjectReference. If used with an ObjectReference, will be

1031

# appended to the path of the resulting URL from the Addressable.

1032

# + optional

1033

"ref": { # ObjectReference contains enough information to let you inspect or modify the # ObjectReference points to an Addressable.

1034

# + optional

1035

# referred object.

1036

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

1037

# +optional

1038

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

1039

# More info:

1040

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

1041

# +optional

1042

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

1043

# More info:

1044

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

1045

# +optional

1046

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

1047

# More info:

1048

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

1049

# +optional

1050

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

1051

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

1052

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

1053

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

1054

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

1055

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

1056

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

1057

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

1058

# object.

1059

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

1060

# More info:

1061

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

1062

# +optional

1063

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

1064

# More info:

1065

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

# +optional

},

},

},

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

1071

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

1072

# all objects users must create.

1073

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

1074

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

1075

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

1076

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

1077

"a_key": "A String",

1078

},

1079

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

1080

#

1081

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

1082

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

1083

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

1084

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

1085

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

1086

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

1087

# server.

1088

#

1089

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

1090

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

1091

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

1092

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

1093

# indicated in the Retry-After header).

1094

#

1095

# Applied only if Name is not specified.

1096

# More info:

1097

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

1098

# +optional

1099

# string generateName = 2;

1100

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

1101

# Is required when creating

1102

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

1103

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

1104

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

1105

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

1106

# +optional

1107

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

1108

#

1109

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

1110

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

1111

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

1112

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

1113

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

1114

#

1115

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

1116

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

1117

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

1118

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

1119

#

1120

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

1121

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

1122

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

1123

# in this list can only be removed.

1124

# +optional

1125

# +patchStrategy=merge

1126

"A String",

1127

],

1128

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

1129

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

1130

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

1131

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

1132

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

1133

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

1134

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

1135

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

1136

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

1137

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

1138

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

1139

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

1140

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

1141

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

1142

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

1143

# resource is fully terminated.

1144

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

1145

#

1146

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

1147

# Read-only.

1148

# More info:

1149

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

1150

# +optional

1151

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

1152

# been deleted, this object will be garbage collected.

1153

# +optional

1154

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

1155

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

1156

# is no namespace field.

1157

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

1158

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

1159

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

1160

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

1161

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

1162

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

1163

# +optional

1164

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

1165

# More info:

1166

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

1167

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

1168

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

1169

# reference is removed.

1170

# Defaults to false.

1171

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

1172

# otherwise 422 (Unprocessable Entity) will be returned.

# +optional

},

],

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

1177

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

1178

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

1179

# represented in RFC3339 form and is in UTC.

1180

#

1181

# Populated by the system.

# Read-only.

# Null for lists.

# More info:

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

1186

# +optional

1187

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

1188

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

1189

# and routes.

1190

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

# +optional

"a_key": "A String",

},

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

1195

# Populated by the system. Read-only.

1196

# +optional

1197

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

1198

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

1199

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

1200

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

1201

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

1202

# particular resource or set of resources.

1203

#

1204

# Populated by the system.

1205

# Read-only.

1206

# Value must be treated as opaque by clients and .

1207

# More info:

1208

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

1209

# +optional

1210

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

1211

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

1212

# allowed to change on PUT operations.

1213

#

1214

# Populated by the system.

1215

# Read-only.

1216

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

1217

# +optional

1218

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

1219

# Populated by the system.

1220

# Read-only.

1221

# +optional

1222

# string selfLink = 4;

1223

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

1224

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

1225

# project ID or project number.

},

},

],

}</pre>

</div>

</body></html>