Class GoogleCloudRunV2WorkerPool
WorkerPool acts as a top-level container that manages a set of configurations and revision templates which implement a pull-based workload. WorkerPool exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership.
Implements
Inherited Members
Namespace: Google.Apis.CloudRun.v2.Data
Assembly: Google.Apis.CloudRun.v2.dll
Syntax
public class GoogleCloudRunV2WorkerPool : IDirectResponseSchema
Properties
Annotations
Optional. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They
are not queryable and should be preserved when modifying objects. Cloud Run API v2 does not support
annotations with run.googleapis.com
, cloud.googleapis.com
, serving.knative.dev
, or
autoscaling.knative.dev
namespaces, and they will be rejected in new resources. All system annotations in
v1 now have a corresponding field in v2 WorkerPool. This field follows Kubernetes annotations' namespacing,
limits, and rules.
Declaration
[JsonProperty("annotations")]
public virtual IDictionary<string, string> Annotations { get; set; }
Property Value
Type | Description |
---|---|
IDictionary<string, string> |
BinaryAuthorization
Optional. Settings for the Binary Authorization feature.
Declaration
[JsonProperty("binaryAuthorization")]
public virtual GoogleCloudRunV2BinaryAuthorization BinaryAuthorization { get; set; }
Property Value
Type | Description |
---|---|
GoogleCloudRunV2BinaryAuthorization |
Client
Arbitrary identifier for the API client.
Declaration
[JsonProperty("client")]
public virtual string Client { get; set; }
Property Value
Type | Description |
---|---|
string |
ClientVersion
Arbitrary version identifier for the API client.
Declaration
[JsonProperty("clientVersion")]
public virtual string ClientVersion { get; set; }
Property Value
Type | Description |
---|---|
string |
Conditions
Output only. The Conditions of all other associated sub-resources. They contain additional diagnostics
information in case the WorkerPool does not reach its Serving state. See comments in reconciling
for
additional information on reconciliation process in Cloud Run.
Declaration
[JsonProperty("conditions")]
public virtual IList<GoogleCloudRunV2Condition> Conditions { get; set; }
Property Value
Type | Description |
---|---|
IList<GoogleCloudRunV2Condition> |
CreateTime
object representation of CreateTimeRaw.
Declaration
[JsonIgnore]
[Obsolete("This property is obsolete and may behave unexpectedly; please use CreateTimeDateTimeOffset instead.")]
public virtual object CreateTime { get; set; }
Property Value
Type | Description |
---|---|
object |
CreateTimeDateTimeOffset
DateTimeOffset representation of CreateTimeRaw.
Declaration
[JsonIgnore]
public virtual DateTimeOffset? CreateTimeDateTimeOffset { get; set; }
Property Value
Type | Description |
---|---|
DateTimeOffset? |
CreateTimeRaw
Output only. The creation time.
Declaration
[JsonProperty("createTime")]
public virtual string CreateTimeRaw { get; set; }
Property Value
Type | Description |
---|---|
string |
Creator
Output only. Email address of the authenticated creator.
Declaration
[JsonProperty("creator")]
public virtual string Creator { get; set; }
Property Value
Type | Description |
---|---|
string |
CustomAudiences
One or more custom audiences that you want this worker pool to support. Specify each custom audience as the full URL in a string. The custom audiences are encoded in the token and used to authenticate requests. For more information, see https://cloud.google.com/run/docs/configuring/custom-audiences.
Declaration
[JsonProperty("customAudiences")]
public virtual IList<string> CustomAudiences { get; set; }
Property Value
Type | Description |
---|---|
IList<string> |
DeleteTime
object representation of DeleteTimeRaw.
Declaration
[JsonIgnore]
[Obsolete("This property is obsolete and may behave unexpectedly; please use DeleteTimeDateTimeOffset instead.")]
public virtual object DeleteTime { get; set; }
Property Value
Type | Description |
---|---|
object |
DeleteTimeDateTimeOffset
DateTimeOffset representation of DeleteTimeRaw.
Declaration
[JsonIgnore]
public virtual DateTimeOffset? DeleteTimeDateTimeOffset { get; set; }
Property Value
Type | Description |
---|---|
DateTimeOffset? |
DeleteTimeRaw
Output only. The deletion time. It is only populated as a response to a Delete request.
Declaration
[JsonProperty("deleteTime")]
public virtual string DeleteTimeRaw { get; set; }
Property Value
Type | Description |
---|---|
string |
Description
User-provided description of the WorkerPool. This field currently has a 512-character limit.
Declaration
[JsonProperty("description")]
public virtual string Description { get; set; }
Property Value
Type | Description |
---|---|
string |
ETag
Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
Declaration
[JsonProperty("etag")]
public virtual string ETag { get; set; }
Property Value
Type | Description |
---|---|
string |
ExpireTime
object representation of ExpireTimeRaw.
Declaration
[JsonIgnore]
[Obsolete("This property is obsolete and may behave unexpectedly; please use ExpireTimeDateTimeOffset instead.")]
public virtual object ExpireTime { get; set; }
Property Value
Type | Description |
---|---|
object |
ExpireTimeDateTimeOffset
DateTimeOffset representation of ExpireTimeRaw.
Declaration
[JsonIgnore]
public virtual DateTimeOffset? ExpireTimeDateTimeOffset { get; set; }
Property Value
Type | Description |
---|---|
DateTimeOffset? |
ExpireTimeRaw
Output only. For a deleted resource, the time after which it will be permamently deleted.
Declaration
[JsonProperty("expireTime")]
public virtual string ExpireTimeRaw { get; set; }
Property Value
Type | Description |
---|---|
string |
Generation
Output only. A number that monotonically increases every time the user modifies the desired state. Please
note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a
string
instead of an integer
.
Declaration
[JsonProperty("generation")]
public virtual long? Generation { get; set; }
Property Value
Type | Description |
---|---|
long? |
InstanceSplitStatuses
Output only. Detailed status information for corresponding instance splits. See comments in reconciling
for additional information on reconciliation process in Cloud Run.
Declaration
[JsonProperty("instanceSplitStatuses")]
public virtual IList<GoogleCloudRunV2InstanceSplitStatus> InstanceSplitStatuses { get; set; }
Property Value
Type | Description |
---|---|
IList<GoogleCloudRunV2InstanceSplitStatus> |
InstanceSplits
Optional. Specifies how to distribute instances over a collection of Revisions belonging to the WorkerPool.
If instance split is empty or not provided, defaults to 100% instances assigned to the latest Ready
Revision.
Declaration
[JsonProperty("instanceSplits")]
public virtual IList<GoogleCloudRunV2InstanceSplit> InstanceSplits { get; set; }
Property Value
Type | Description |
---|---|
IList<GoogleCloudRunV2InstanceSplit> |
Labels
Optional. Unstructured key value map that can be used to organize and categorize objects. User-provided
labels are shared with Google's billing system, so they can be used to filter, or break down billing charges
by team, component, environment, state, etc. For more information, visit
https://cloud.google.com/resource-manager/docs/creating-managing-labels or
https://cloud.google.com/run/docs/configuring/labels. Cloud Run API v2 does not support labels with
run.googleapis.com
, cloud.googleapis.com
, serving.knative.dev
, or autoscaling.knative.dev
namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2
WorkerPool.
Declaration
[JsonProperty("labels")]
public virtual IDictionary<string, string> Labels { get; set; }
Property Value
Type | Description |
---|---|
IDictionary<string, string> |
LastModifier
Output only. Email address of the last authenticated modifier.
Declaration
[JsonProperty("lastModifier")]
public virtual string LastModifier { get; set; }
Property Value
Type | Description |
---|---|
string |
LatestCreatedRevision
Output only. Name of the last created revision. See comments in reconciling
for additional information on
reconciliation process in Cloud Run.
Declaration
[JsonProperty("latestCreatedRevision")]
public virtual string LatestCreatedRevision { get; set; }
Property Value
Type | Description |
---|---|
string |
LatestReadyRevision
Output only. Name of the latest revision that is serving traffic. See comments in reconciling
for
additional information on reconciliation process in Cloud Run.
Declaration
[JsonProperty("latestReadyRevision")]
public virtual string LatestReadyRevision { get; set; }
Property Value
Type | Description |
---|---|
string |
LaunchStage
Optional. The launch stage as defined by Google Cloud Platform Launch
Stages. Cloud Run supports ALPHA
, BETA
, and GA
. If no
value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview
features in that stage. On read (or output), describes whether the resource uses preview features. For
example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be
BETA on output.
Declaration
[JsonProperty("launchStage")]
public virtual string LaunchStage { get; set; }
Property Value
Type | Description |
---|---|
string |
Name
The fully qualified name of this WorkerPool. In CreateWorkerPoolRequest, this field is ignored, and instead composed from CreateWorkerPoolRequest.parent and CreateWorkerPoolRequest.worker_id. Format: projects/{project}/locations/{location}/workerPools/{worker_id}
Declaration
[JsonProperty("name")]
public virtual string Name { get; set; }
Property Value
Type | Description |
---|---|
string |
ObservedGeneration
Output only. The generation of this WorkerPool currently serving traffic. See comments in reconciling
for
additional information on reconciliation process in Cloud Run. Please note that unlike v1, this is an int64
value. As with most Google APIs, its JSON representation will be a string
instead of an integer
.
Declaration
[JsonProperty("observedGeneration")]
public virtual long? ObservedGeneration { get; set; }
Property Value
Type | Description |
---|---|
long? |
Reconciling
Output only. Returns true if the WorkerPool is currently being acted upon by the system to bring it into the
desired state. When a new WorkerPool is created, or an existing one is updated, Cloud Run will
asynchronously perform all necessary steps to bring the WorkerPool to the desired serving state. This
process is called reconciliation. While reconciliation is in process, observed_generation
,
latest_ready_revison
, traffic_statuses
, and uri
will have transient values that might mismatch the
intended state: Once reconciliation is over (and this field is false), there are two possible outcomes:
reconciliation succeeded and the serving state matches the WorkerPool, or there was an error, and
reconciliation failed. This state can be found in terminal_condition.state
. If reconciliation succeeded,
the following fields will match: traffic
and traffic_statuses
, observed_generation
and generation
,
latest_ready_revision
and latest_created_revision
. If reconciliation failed, traffic_statuses
,
observed_generation
, and latest_ready_revision
will have the state of the last serving revision, or
empty for newly created WorkerPools. Additional information on the failure can be found in
terminal_condition
and conditions
.
Declaration
[JsonProperty("reconciling")]
public virtual bool? Reconciling { get; set; }
Property Value
Type | Description |
---|---|
bool? |
SatisfiesPzs
Output only. Reserved for future use.
Declaration
[JsonProperty("satisfiesPzs")]
public virtual bool? SatisfiesPzs { get; set; }
Property Value
Type | Description |
---|---|
bool? |
Scaling
Optional. Specifies worker-pool-level scaling settings
Declaration
[JsonProperty("scaling")]
public virtual GoogleCloudRunV2WorkerPoolScaling Scaling { get; set; }
Property Value
Type | Description |
---|---|
GoogleCloudRunV2WorkerPoolScaling |
Template
Required. The template used to create revisions for this WorkerPool.
Declaration
[JsonProperty("template")]
public virtual GoogleCloudRunV2WorkerPoolRevisionTemplate Template { get; set; }
Property Value
Type | Description |
---|---|
GoogleCloudRunV2WorkerPoolRevisionTemplate |
TerminalCondition
Output only. The Condition of this WorkerPool, containing its readiness status, and detailed error
information in case it did not reach a serving state. See comments in reconciling
for additional
information on reconciliation process in Cloud Run.
Declaration
[JsonProperty("terminalCondition")]
public virtual GoogleCloudRunV2Condition TerminalCondition { get; set; }
Property Value
Type | Description |
---|---|
GoogleCloudRunV2Condition |
Uid
Output only. Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
Declaration
[JsonProperty("uid")]
public virtual string Uid { get; set; }
Property Value
Type | Description |
---|---|
string |
UpdateTime
object representation of UpdateTimeRaw.
Declaration
[JsonIgnore]
[Obsolete("This property is obsolete and may behave unexpectedly; please use UpdateTimeDateTimeOffset instead.")]
public virtual object UpdateTime { get; set; }
Property Value
Type | Description |
---|---|
object |
UpdateTimeDateTimeOffset
DateTimeOffset representation of UpdateTimeRaw.
Declaration
[JsonIgnore]
public virtual DateTimeOffset? UpdateTimeDateTimeOffset { get; set; }
Property Value
Type | Description |
---|---|
DateTimeOffset? |
UpdateTimeRaw
Output only. The last-modified time.
Declaration
[JsonProperty("updateTime")]
public virtual string UpdateTimeRaw { get; set; }
Property Value
Type | Description |
---|---|
string |