REST Resource: projects.locations.fleets

Resource: Fleet

Fleet contains the Fleet-wide metadata and configuration.

JSON representation
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "uid": string,
  "state": {
    object (FleetLifecycleState)
  },
  "defaultClusterConfig": {
    object (DefaultClusterConfig)
  },
  "labels": {
    string: string,
    ...
  }
}
Fields
name

string

Output only. The full, unique resource name of this fleet in the format of projects/{project}/locations/{location}/fleets/{fleet}.

Each Google Cloud project can have at most one fleet resource, named "default".

displayName

string

Optional. A user-assigned display name of the Fleet. When present, it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.

Example: Production Fleet

createTime

string (Timestamp format)

Output only. When the Fleet was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. When the Fleet was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

deleteTime

string (Timestamp format)

Output only. When the Fleet was deleted.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

uid

string

Output only. Google-generated UUID for this resource. This is unique across all Fleet resources. If a Fleet resource is deleted and another resource with the same name is created, it gets a different uid.

state

object (FleetLifecycleState)

Output only. State of the namespace resource.

defaultClusterConfig

object (DefaultClusterConfig)

Optional. The default cluster configurations to apply across the fleet.

labels

map (key: string, value: string)

Optional. Labels for this Fleet.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FleetLifecycleState

FleetLifecycleState describes the state of a Fleet resource.

JSON representation
{
  "code": enum (FleetLifecycleState.Code)
}
Fields
code

enum (FleetLifecycleState.Code)

Output only. The current state of the Fleet resource.

FleetLifecycleState.Code

Code describes the state of a Fleet resource.

Enums
CODE_UNSPECIFIED The code is not set.
CREATING The fleet is being created.
READY The fleet active.
DELETING The fleet is being deleted.
UPDATING The fleet is being updated.

DefaultClusterConfig

DefaultClusterConfig describes the default cluster configurations to be applied to all clusters born-in-fleet.

JSON representation
{
  "securityPostureConfig": {
    object (SecurityPostureConfig)
  },
  "binaryAuthorizationConfig": {
    object (BinaryAuthorizationConfig)
  }
}
Fields
securityPostureConfig

object (SecurityPostureConfig)

Enable/Disable Security Posture features for the cluster.

binaryAuthorizationConfig

object (BinaryAuthorizationConfig)

Optional. Enable/Disable binary authorization features for the cluster.

SecurityPostureConfig

SecurityPostureConfig defines the flags needed to enable/disable features for the Security Posture API.

JSON representation
{
  "mode": enum (SecurityPostureConfig.Mode),
  "vulnerabilityMode": enum (SecurityPostureConfig.VulnerabilityMode)
}
Fields
mode

enum (SecurityPostureConfig.Mode)

Sets which mode to use for Security Posture features.

vulnerabilityMode

enum (SecurityPostureConfig.VulnerabilityMode)

Sets which mode to use for vulnerability scanning.

SecurityPostureConfig.Mode

Mode defines enablement mode for GKE Security posture features.

Enums
MODE_UNSPECIFIED Default value not specified.
DISABLED Disables Security Posture features on the cluster.
BASIC Applies Security Posture features on the cluster.

SecurityPostureConfig.VulnerabilityMode

VulnerabilityMode defines enablement mode for vulnerability scanning.

Enums
VULNERABILITY_MODE_UNSPECIFIED Default value not specified.
VULNERABILITY_DISABLED Disables vulnerability scanning on the cluster.
VULNERABILITY_BASIC Applies basic vulnerability scanning on the cluster.
VULNERABILITY_ENTERPRISE Applies the Security Posture's vulnerability on cluster Enterprise level features.

BinaryAuthorizationConfig

BinaryAuthorizationConfig defines the fleet level configuration of binary authorization feature.

JSON representation
{
  "evaluationMode": enum (BinaryAuthorizationConfig.EvaluationMode),
  "policyBindings": [
    {
      object (BinaryAuthorizationConfig.PolicyBinding)
    }
  ]
}
Fields
evaluationMode

enum (BinaryAuthorizationConfig.EvaluationMode)

Optional. Mode of operation for binauthz policy evaluation.

policyBindings[]

object (BinaryAuthorizationConfig.PolicyBinding)

Optional. Binauthz policies that apply to this cluster.

BinaryAuthorizationConfig.EvaluationMode

Binary Authorization mode of operation.

Enums
EVALUATION_MODE_UNSPECIFIED Default value
DISABLED Disable BinaryAuthorization
POLICY_BINDINGS Use Binary Authorization with the policies specified in policyBindings.

BinaryAuthorizationConfig.PolicyBinding

Binauthz policy that applies to this cluster.

JSON representation
{
  "name": string
}
Fields
name

string

The relative resource name of the binauthz platform policy to audit. GKE platform policies have the following format: projects/{project_number}/platforms/gke/policies/{policy_id}.

Methods

create

Creates a fleet.

delete

Removes a Fleet.

get

Returns the details of a fleet.

list

Returns all fleets within an organization or a project that the caller has access to.

patch

Updates a fleet.