Class Operation (2.45.0)

Operation(mapping=None, *, ignore_unknown_fields=False, **kwargs)

This operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

Attributes

NameDescription
name str
The server-assigned ID for the operation.
zone str
The name of the Google Compute Engine zone __ in which the operation is taking place. This field is deprecated, use location instead.
operation_type google.cloud.container_v1.types.Operation.Type
The operation type.
status google.cloud.container_v1.types.Operation.Status
The current status of the operation.
detail str
Detailed operation progress, if available.
status_message str
Output only. If an error has occurred, a textual description of the error. Deprecated. Use the field error instead.
self_link str
Server-defined URI for the operation. Example: https://container.googleapis.com/v1alpha1/projects/123/locations/us-central1/operations/operation-123.
target_link str
Server-defined URI for the target of the operation. The format of this is a URI to the resource being modified (such as a cluster, node pool, or node). For node pool repairs, there may be multiple nodes being repaired, but only one will be the target. Examples: - https://container.googleapis.com/v1/projects/123/locations/us-central1/clusters/my-cluster https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np/node/my-node
location str
[Output only] The name of the Google Compute Engine zone __ or region __ in which the cluster resides.
start_time str
[Output only] The time the operation started, in RFC3339 __ text format.
end_time str
[Output only] The time the operation completed, in RFC3339 __ text format.
progress google.cloud.container_v1.types.OperationProgress
Output only. [Output only] Progress information for an operation.
cluster_conditions MutableSequence[google.cloud.container_v1.types.StatusCondition]
Which conditions caused the current cluster state. Deprecated. Use field error instead.
nodepool_conditions MutableSequence[google.cloud.container_v1.types.StatusCondition]
Which conditions caused the current node pool state. Deprecated. Use field error instead.
error google.rpc.status_pb2.Status
The error result of the operation in case of failure.

Classes

Status

Status(value)

Current status of the operation.

Values: STATUS_UNSPECIFIED (0): Not set. PENDING (1): The operation has been created. RUNNING (2): The operation is currently running. DONE (3): The operation is done, either cancelled or completed. ABORTING (4): The operation is aborting.

Type

Type(value)

Operation type categorizes the operation.

Values: TYPE_UNSPECIFIED (0): Not set. CREATE_CLUSTER (1): The cluster is being created. The cluster should be assumed to be unusable until the operation finishes.

    In the event of the operation failing, the cluster will
    enter the `ERROR state][Cluster.Status.ERROR]` and eventually
    be deleted.
DELETE_CLUSTER (2):
    The cluster is being deleted. The cluster should be assumed
    to be unusable as soon as this operation starts.

    In the event of the operation failing, the cluster will
    enter the `ERROR state][Cluster.Status.ERROR]` and the
    deletion will be automatically retried until completed.
UPGRADE_MASTER (3):
    The [cluster
    version][google.container.v1.ClusterUpdate.desired_master_version]
    is being updated. Note that this includes "upgrades" to the
    same version, which are simply a recreation. This also
    includes
    `auto-upgrades <https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-upgrades#upgrading_automatically>`__.
    For more details, see `documentation on cluster
    upgrades <https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-upgrades#cluster_upgrades>`__.
UPGRADE_NODES (4):
    A node pool is being updated. Despite calling this an
    "upgrade", this includes most forms of updates to node
    pools. This also includes
    `auto-upgrades <https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-upgrades>`__.

    This operation sets the
    `progress][google.container.v1.Operation.progress]` field and
    may be
    `canceled][google.container.v1.ClusterManager.CancelOperation]`.

    The upgrade strategy depends on `node pool
    configuration <https://cloud.google.com/kubernetes-engine/docs/concepts/node-pool-upgrade-strategies>`__.
    The nodes are generally still usable during this operation.
REPAIR_CLUSTER (5):
    A problem has been detected with the control plane and is
    being repaired. This operation type is initiated by GKE. For
    more details, see `documentation on
    repairs <https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions#repairs>`__.
UPDATE_CLUSTER (6):
    The cluster is being updated. This is a broad category of
    operations and includes operations that only change metadata
    as well as those that must recreate the entire cluster. If
    the control plane must be recreated, this will cause
    temporary downtime for zonal clusters.

    Some features require recreating the nodes as well. Those
    will be recreated as separate operations and the update may
    not be completely functional until the node pools
    recreations finish. Node recreations will generally follow
    `maintenance
    policies <https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions>`__.

    Some GKE-initiated operations use this type. This includes
    certain types of auto-upgrades and incident mitigations.
CREATE_NODE_POOL (7):
    A node pool is being created. The node pool should be
    assumed to be unusable until this operation finishes. In the
    event of an error, the node pool may be partially created.

    If enabled, `node
    autoprovisioning <https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-provisioning>`__
    may have automatically initiated such operations.
DELETE_NODE_POOL (8):
    The node pool is being deleted. The node pool
    should be assumed to be unusable as soon as this
    operation starts.
SET_NODE_POOL_MANAGEMENT (9):
    The node pool's
    `manamagent][google.container.v1.NodePool.management]` field
    is being updated. These operations only update metadata and
    may be concurrent with most other operations.
AUTO_REPAIR_NODES (10):
    A problem has been detected with nodes and `they are being
    repaired <https://cloud.google.com/kubernetes-engine/docs/how-to/node-auto-repair>`__.
    This operation type is initiated by GKE, typically
    automatically. This operation may be concurrent with other
    operations and there may be multiple repairs occurring on
    the same node pool.
AUTO_UPGRADE_NODES (11):
    Unused. Automatic node upgrade uses
    `UPGRADE_NODES][google.container.v1.Operation.Type.UPGRADE_NODES]`.
SET_LABELS (12):
    Unused. Updating labels uses
    `UPDATE_CLUSTER][google.container.v1.Operation.Type.UPDATE_CLUSTER]`.
SET_MASTER_AUTH (13):
    Unused. Updating master auth uses
    `UPDATE_CLUSTER][google.container.v1.Operation.Type.UPDATE_CLUSTER]`.
SET_NODE_POOL_SIZE (14):
    The node pool is being resized. With the
    exception of resizing to or from size zero, the
    node pool is generally usable during this
    operation.
SET_NETWORK_POLICY (15):
    Unused. Updating network policy uses
    `UPDATE_CLUSTER][google.container.v1.Operation.Type.UPDATE_CLUSTER]`.
SET_MAINTENANCE_POLICY (16):
    Unused. Updating maintenance policy uses
    `UPDATE_CLUSTER][google.container.v1.Operation.Type.UPDATE_CLUSTER]`.
RESIZE_CLUSTER (18):
    The control plane is being resized. This operation type is
    initiated by GKE. These operations are often performed
    preemptively to ensure that the control plane has sufficient
    resources and is not typically an indication of issues. For
    more details, see `documentation on
    resizes <https://cloud.google.com/kubernetes-engine/docs/concepts/maintenance-windows-and-exclusions#repairs>`__.
FLEET_FEATURE_UPGRADE (19):
    Fleet features of GKE Enterprise are being
    upgraded. The cluster should be assumed to be
    blocked for other upgrades until the operation
    finishes.