API Reference
Packages
objectstorage.k8s.io/v1alpha2
Package v1alpha2 contains API Schema definitions for the objectstorage v1alpha2 API group.
Resource Types
- Bucket
- BucketAccess
- BucketAccessClass
- BucketAccessClassList
- BucketAccessList
- BucketClaim
- BucketClaimList
- BucketClass
- BucketClassList
- BucketList
Bucket
Bucket is the Schema for the buckets API
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | Bucket | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ObjectMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
spec BucketSpec | spec defines the desired state of Bucket | ||
status BucketStatus | status defines the observed state of Bucket |
BucketAccess
BucketAccess is the Schema for the bucketaccesses API
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketAccess | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ObjectMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
spec BucketAccessSpec | spec defines the desired state of BucketAccess | ||
status BucketAccessStatus | status defines the observed state of BucketAccess |
BucketAccessClass
BucketAccessClass is the Schema for the bucketaccessclasses API
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketAccessClass | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ObjectMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
spec BucketAccessClassSpec | spec defines the desired state of BucketAccessClass | ||
status BucketAccessClassStatus | status defines the observed state of BucketAccessClass |
BucketAccessClassList
BucketAccessClassList contains a list of BucketAccessClass
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketAccessClassList | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ListMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
items BucketAccessClass array |
BucketAccessClassSpec
BucketAccessClassSpec defines the desired state of BucketAccessClass
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
foo string | foo is an example field of BucketAccessClass. Edit bucketaccessclass_types.go to remove/update |
BucketAccessClassStatus
BucketAccessClassStatus defines the observed state of BucketAccessClass.
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
conditions Condition array | conditions represent the current state of the BucketAccessClass resource. Each condition has a unique type and reflects the status of a specific aspect of the resource. Standard condition types include: - "Available": the resource is fully functional - "Progressing": the resource is being created or updated - "Degraded": the resource failed to reach or maintain its desired state The status of each condition is one of True, False, or Unknown. |
BucketAccessList
BucketAccessList contains a list of BucketAccess
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketAccessList | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ListMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
items BucketAccess array |
BucketAccessSpec
BucketAccessSpec defines the desired state of BucketAccess
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
foo string | foo is an example field of BucketAccess. Edit bucketaccess_types.go to remove/update |
BucketAccessStatus
BucketAccessStatus defines the observed state of BucketAccess.
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
conditions Condition array | conditions represent the current state of the BucketAccess resource. Each condition has a unique type and reflects the status of a specific aspect of the resource. Standard condition types include: - "Available": the resource is fully functional - "Progressing": the resource is being created or updated - "Degraded": the resource failed to reach or maintain its desired state The status of each condition is one of True, False, or Unknown. |
BucketClaim
BucketClaim is the Schema for the bucketclaims API
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketClaim | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ObjectMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
spec BucketClaimSpec | spec defines the desired state of BucketClaim | ||
status BucketClaimStatus | status defines the observed state of BucketClaim |
BucketClaimList
BucketClaimList contains a list of BucketClaim
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketClaimList | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ListMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
items BucketClaim array |
BucketClaimReference
BucketClaimReference is a reference to a BucketClaim object.
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
name string | name is the name of the BucketClaim being referenced. | MinLength: 1 | |
namespace string | namespace is the namespace of the BucketClaim being referenced. If empty, the Kubernetes 'default' namespace is assumed. namespace is immutable except to update '' to 'default'. | MinLength: 0 | |
uid UID | uid is the UID of the BucketClaim being referenced. Once set, the UID is immutable. |
BucketClaimSpec
BucketClaimSpec defines the desired state of BucketClaim
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
bucketClassName string | bucketClassName selects the BucketClass for provisioning the BucketClaim. This field is used only for BucketClaim dynamic provisioning. If unspecified, existingBucketName must be specified for binding to an existing Bucket. | ||
protocols ObjectProtocol array | protocols lists object storage protocols that the provisioned Bucket must support. If specified, COSI will verify that each item is advertised as supported by the driver. | ||
existingBucketName string | existingBucketName selects the name of an existing Bucket resource that this BucketClaim should bind to. This field is used only for BucketClaim static provisioning. If unspecified, bucketClassName must be specified for dynamically provisioning a new bucket. |
BucketClaimStatus
BucketClaimStatus defines the observed state of BucketClaim.
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
boundBucketName string | boundBucketName is the name of the Bucket this BucketClaim is bound to. Once set, this is immutable. | ||
readyToUse boolean | readyToUse indicates that the bucket is ready for consumption by workloads. | ||
protocols ObjectProtocol array | protocols is the set of protocols the bound Bucket reports to support. BucketAccesses can request access to this BucketClaim using any of the protocols reported here. | ||
error TimestampedError | error holds the most recent error message, with a timestamp. This is cleared when provisioning is successful. |
BucketClass
BucketClass defines a named "class" of object storage buckets. Different classes might map to different object storage protocols, quality-of-service levels, backup policies, or any other arbitrary configuration determined by storage administrators. The name of a BucketClass object is significant, and is how users can request a particular class.
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketClass | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ObjectMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
spec BucketClassSpec | spec defines the BucketClass. spec is entirely immutable. |
BucketClassList
BucketClassList contains a list of BucketClass
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketClassList | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ListMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
items BucketClass array |
BucketClassSpec
BucketClassSpec defines the BucketClass.
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
driverName string | driverName is the name of the driver that fulfills requests for this BucketClass. | MinLength: 1 | |
deletionPolicy BucketDeletionPolicy | deletionPolicy determines whether a Bucket created through the BucketClass should be deleted when its bound BucketClaim is deleted. Possible values: - Retain: keep both the Bucket object and the backend bucket - Delete: delete both the Bucket object and the backend bucket | Enum: [Retain Delete] | |
parameters object (keys:string, values:string) | parameters is an opaque map of driver-specific configuration items passed to the driver that fulfills requests for this BucketClass. |
BucketDeletionPolicy
Underlying type: string
BucketDeletionPolicy configures COSI's behavior when a Bucket resource is deleted.
Validation:
- Enum: [Retain Delete]
Appears in:
| Field | Description |
|---|---|
Retain | BucketDeletionPolicyRetain configures COSI to keep the Bucket object as well as the backend bucket when a Bucket resource is deleted. |
Delete | BucketDeletionPolicyDelete configures COSI to delete the Bucket object as well as the backend bucket when a Bucket resource is deleted. |
BucketList
BucketList contains a list of Bucket
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | objectstorage.k8s.io/v1alpha2 | ||
kind string | BucketList | ||
kind string | Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds | ||
apiVersion string | APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources | ||
metadata ListMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
items Bucket array |
BucketSpec
BucketSpec defines the desired state of Bucket
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
driverName string | driverName is the name of the driver that fulfills requests for this Bucket. | MinLength: 1 | |
deletionPolicy BucketDeletionPolicy | deletionPolicy determines whether a Bucket should be deleted when its bound BucketClaim is deleted. This is mutable to allow Admins to change the policy after creation. Possible values: - Retain: keep both the Bucket object and the backend bucket - Delete: delete both the Bucket object and the backend bucket | Enum: [Retain Delete] | |
parameters object (keys:string, values:string) | parameters is an opaque map of driver-specific configuration items passed to the driver that fulfills requests for this Bucket. | ||
protocols ObjectProtocol array | protocols lists object store protocols that the provisioned Bucket must support. If specified, COSI will verify that each item is advertised as supported by the driver. | ||
bucketClaim BucketClaimReference | bucketClaim references the BucketClaim that resulted in the creation of this Bucket. For statically-provisioned buckets, set the namespace and name of the BucketClaim that is allowed to bind to this Bucket. |
BucketStatus
BucketStatus defines the observed state of Bucket.
Appears in:
ObjectProtocol
Underlying type: string
ObjectProtocol represents an object protocol type.
Appears in:
TimestampedError
TimestampedError contains an error message with timestamp.
Appears in:
| Field | Description | Default | Validation |
|---|---|---|---|
time Time | time is the timestamp when the error was encountered. | ||
message string | message is a string detailing the encountered error. NOTE: message will be logged, and it should not contain sensitive information. |