REST Resource: namespaces.configurations

Resource: Configuration

Configuration represents the "floating HEAD" of a linear history of Revisions, and optionally how the containers those revisions reference are built. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/master/docs/spec/overview.md#configuration

JSON representation
{
  "apiVersion": string,
  "kind": string,
  "metadata": {
    object (ObjectMeta)
  },
  "spec": {
    object (ConfigurationSpec)
  },
  "status": {
    object (ConfigurationStatus)
  }
}
Fields
apiVersion

string

The API version for this call such as "serving.knative.dev/v1".

kind

string

The kind of resource, in this case always "Configuration".

metadata

object (ObjectMeta)

Metadata associated with this Configuration, including name, namespace, labels, and annotations.

spec

object (ConfigurationSpec)

Spec holds the desired state of the Configuration (from the client).

status

object (ConfigurationStatus)

Status communicates the observed state of the Configuration (from the controller).

ConfigurationSpec

ConfigurationSpec holds the desired state of the Configuration (from the client).

JSON representation
{
  "template": {
    object (RevisionTemplate)
  }
}
Fields
template

object (RevisionTemplate)

Optional metadata for this Revision, including labels and annotations. Name will be generated by the Configuration. To set minimum instances for this revision, use the "autoscaling.knative.dev/minScale" annotation key. (Cloud Run for Anthos only). To set maximum instances for this revision, use the "autoscaling.knative.dev/maxScale" annotation key. To set Cloud SQL connections for the revision, use the "run.googleapis.com/cloudsql-instances" annotation key. Values should be comma separated.

ConfigurationStatus

ConfigurationStatus communicates the observed state of the Configuration (from the controller).

JSON representation
{
  "observedGeneration": number,
  "latestCreatedRevisionName": string,
  "latestReadyRevisionName": string,
  "conditions": [
    {
      object (Condition)
    }
  ]
}
Fields
observedGeneration

number

ObservedGeneration is the 'Generation' of the Configuration that was last processed by the controller. The observed generation is updated even if the controller failed to process the spec and create the Revision.

Clients polling for completed reconciliation should poll until observedGeneration = metadata.generation, and the Ready condition's status is True or False.

latestCreatedRevisionName

string

LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.

latestReadyRevisionName

string

LatestReadyRevisionName holds the name of the latest Revision stamped out from this Configuration that has had its "Ready" condition become "True".

conditions[]

object (Condition)

Conditions communicates information about ongoing/complete reconciliation processes that bring the "spec" inline with the observed state of the world.

Methods

get

Get information about a configuration.

list

List configurations.
Was this page helpful? Let us know how we did:

Send feedback about...