/apis/storage.k8s.io/v1beta1/csistoragecapacities

开发中

GET

storage_v1beta1

list or watch objects of kind CSIStorageCapacity

请求参数

无

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

CSIStorageCapacityList is a collection of CSIStorageCapacity objects.

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

items

array[object (io.k8s.api.storage.v1beta1.CSIStorageCapacity) {7}]

必需

Items is the list of CSIStorageCapacity objects.

apiVersion

string

可选

capacity

string

可选

Quantity is a fixed-point representation of a number. It provides convenient marshaling/unmarshaling in JSON and YAML, in addition to String() and AsInt64() accessors.

The serialization format is:

::=
(Note that may be empty, from the "" case in .)
::= 0 | 1 | ... | 9 ::= | ::= | . | . | . ::= "+" | "-" ::= | ::= | | ::= Ki | Mi | Gi | Ti | Pi | Ei
(International System of units; See: http://physics.nist.gov/cuu/Units/binary.html)
::= m | "" | k | M | G | T | P | E
(Note that 1024 = 1Ki but 1000 = 1k; I didn't choose the capitalization.)
::= "e" | "E"

No matter which of the three exponent forms is used, no quantity may represent a number greater than 2^63-1 in magnitude, nor may it have more than 3 decimal places. Numbers larger or more precise will be capped or rounded up. (E.g.: 0.1m will rounded up to 1m.) This may be extended in the future if we require larger or smaller quantities.

When a Quantity is parsed from a string, it will remember the type of suffix it had, and will use the same type again when it is serialized.

Before serializing, Quantity will be put in "canonical form". This means that Exponent/suffix will be adjusted up or down (with a corresponding increase or decrease in Mantissa) such that:
a. No precision is lost
b. No fractional digits will be emitted
c. The exponent (or suffix) is as large as possible.
The sign will be omitted unless the number is negative.

Examples:
1.5 will be serialized as "1500m"
1.5Gi will be serialized as "1536Mi"

Note that the quantity will NEVER be internally represented by a floating point number. That is the whole point of this exercise.

Non-canonical values will still parse as long as they are well formed, but will be re-emitted in their canonical form. (So always use canonical form, or don't diff.)

This format is intended to make it difficult to use these numbers without writing some sort of special handling code in the hopes that that will cause implementors to also use a fixed point implementation.

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

maximumVolumeSize

string

可选

Quantity is a fixed-point representation of a number. It provides convenient marshaling/unmarshaling in JSON and YAML, in addition to String() and AsInt64() accessors.

The serialization format is:

When a Quantity is parsed from a string, it will remember the type of suffix it had, and will use the same type again when it is serialized.

Examples:
1.5 will be serialized as "1500m"
1.5Gi will be serialized as "1536Mi"

Note that the quantity will NEVER be internally represented by a floating point number. That is the whole point of this exercise.

Non-canonical values will still parse as long as they are well formed, but will be re-emitted in their canonical form. (So always use canonical form, or don't diff.)

metadata

object (io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta)

可选

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

nodeTopology

object (io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector)

可选

A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects.

storageClassName

string

必需

The name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.

kind

string

可选

metadata

object (io.k8s.apimachinery.pkg.apis.meta.v1.ListMeta)

可选

ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.

continue

string

可选

continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.

remainingItemCount

integer <int64>

可选

remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is estimating the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.

resourceVersion

string

可选

String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

selfLink

string

可选

selfLink is a URL representing this object. Populated by the system. Read-only.

DEPRECATED Kubernetes will stop propagating this field in 1.20 release and the field is planned to be removed in 1.21 release.

示例

{
    "apiVersion": "string",
    "items": [
        {
            "apiVersion": "string",
            "capacity": "string",
            "kind": "string",
            "maximumVolumeSize": "string",
            "metadata": {
                "annotations": {
                    "property1": "string",
                    "property2": "string"
                },
                "clusterName": "string",
                "creationTimestamp": "2019-08-24T14:15:22Z",
                "deletionGracePeriodSeconds": 0,
                "deletionTimestamp": "2019-08-24T14:15:22Z",
                "finalizers": [
                    "string"
                ],
                "generateName": "string",
                "generation": 0,
                "labels": {
                    "property1": "string",
                    "property2": "string"
                },
                "managedFields": [
                    {
                        "apiVersion": "string",
                        "fieldsType": "string",
                        "fieldsV1": {},
                        "manager": "string",
                        "operation": "string",
                        "time": "2019-08-24T14:15:22Z"
                    }
                ],
                "name": "string",
                "namespace": "string",
                "ownerReferences": [
                    {
                        "apiVersion": "string",
                        "blockOwnerDeletion": true,
                        "controller": true,
                        "kind": "string",
                        "name": "string",
                        "uid": "string"
                    }
                ],
                "resourceVersion": "string",
                "selfLink": "string",
                "uid": "string"
            },
            "nodeTopology": {
                "matchExpressions": [
                    {
                        "key": "string",
                        "operator": "string",
                        "values": [
                            "string"
                        ]
                    }
                ],
                "matchLabels": {
                    "property1": "string",
                    "property2": "string"
                }
            },
            "storageClassName": "string"
        }
    ],
    "kind": "string",
    "metadata": {
        "continue": "string",
        "remainingItemCount": 0,
        "resourceVersion": "string",
        "selfLink": "string"
    }
}

🟠401Unauthorized

修改于 2022-07-15 03:15:52

/apis/storage.k8s.io/v1beta1/csinodes/{name}

/apis/storage.k8s.io/v1beta1/namespaces/{namespace}/csistoragecapacities