華為云計(jì)算 云知識(shí) 查詢所有v1版本的APIgetCoreV1APIResources
查詢所有v1版本的APIgetCoreV1APIResources

 

功能介紹

get available resources

調(diào)用方法

請(qǐng)參見如何調(diào)用API。

URI

GET /api/v1

請(qǐng)求參數(shù)

表1 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。

通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)。

響應(yīng)參數(shù)

狀態(tài)碼: 200

表2 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

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

groupVersion

String

groupVersion is the group and version this APIResourceList is for.

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

resources

Array of io.k8s.apimachinery.pkg.apis.meta.v1.APIResource objects

resources contains the name of the resources and if they are namespaced.

表3 io.k8s.apimachinery.pkg.apis.meta.v1.APIResource

參數(shù)

參數(shù)類型

描述

categories

Array of strings

categories is a list of the grouped resources this resource belongs to (e.g. 'all')

group

String

group is the preferred group of the resource. Empty implies the group of the containing resource list. For subresources, this may have a different value, for example: Scale".

kind

String

kind is the kind for the resource (e.g. 'Foo' is the kind for a resource 'foo')

name

String

name is the plural name of the resource.

namespaced

Boolean

namespaced indicates if a resource is namespaced or not.

shortNames

Array of strings

shortNames is a list of suggested short names of the resource.

singularName

String

singularName is the singular name of the resource. This allows clients to handle plural and singular opaquely. The singularName is more correct for reporting status on a single item and both singular and plural are allowed from the kubectl CLI interface.

storageVersionHash

String

The hash value of the storage version, the version this resource is converted to when written to the data store. Value must be treated as opaque by clients. Only equality comparison on the value is valid. This is an alpha feature and may change or be removed in the future. The field is populated by the apiserver only if the StorageVersionHash feature gate is enabled. This field will remain optional even if it graduates.

verbs

Array of strings

verbs is a list of supported kube verbs (this includes get, list, watch, create, update, patch, delete, deletecollection, and proxy)

version

String

version is the preferred version of the resource. Empty implies the version of the containing resource list For subresources, this may have a different value, for example: v1 (while inside a v1beta1 version of the core resource's group)".

請(qǐng)求示例

無(wú)

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "groupVersion" : "v1",
  "kind" : "APIResourceList",
  "resources" : [ {
    "kind" : "ConfigMap",
    "name" : "configmaps",
    "namespaced" : true,
    "shortNames" : [ "cm" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "deletecollection", "get", "list", "patch", "update", "watch" ]
  }, {
    "kind" : "Endpoints",
    "name" : "endpoints",
    "namespaced" : true,
    "shortNames" : [ "ep" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "deletecollection", "get", "list", "patch", "update", "watch" ]
  }, {
    "kind" : "Event",
    "name" : "events",
    "namespaced" : true,
    "shortNames" : [ "ev" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "deletecollection", "get", "list", "patch", "update", "watch" ]
  }, {
    "kind" : "Namespace",
    "name" : "namespaces",
    "namespaced" : false,
    "shortNames" : [ "ns" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "get", "list", "patch", "update", "watch" ]
  }, {
    "kind" : "PersistentVolumeClaim",
    "name" : "persistentvolumeclaims",
    "namespaced" : true,
    "shortNames" : [ "pvc" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "deletecollection", "get", "list", "patch", "update", "watch" ]
  }, {
    "categories" : [ "all" ],
    "kind" : "Pod",
    "name" : "pods",
    "namespaced" : true,
    "shortNames" : [ "po" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "deletecollection", "get", "list", "patch", "update", "watch" ]
  }, {
    "kind" : "Pod",
    "name" : "pods/exec",
    "namespaced" : true,
    "singularName" : "",
    "verbs" : [ ]
  }, {
    "kind" : "Pod",
    "name" : "pods/log",
    "namespaced" : true,
    "singularName" : "",
    "verbs" : [ "get" ]
  }, {
    "kind" : "Pod",
    "name" : "pods/status",
    "namespaced" : true,
    "singularName" : "",
    "verbs" : [ "get", "patch", "update" ]
  }, {
    "kind" : "ResourceQuota",
    "name" : "resourcequotas",
    "namespaced" : true,
    "shortNames" : [ "quota" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "deletecollection", "get", "list", "patch", "update", "watch" ]
  }, {
    "kind" : "Secret",
    "name" : "secrets",
    "namespaced" : true,
    "singularName" : "",
    "verbs" : [ "create", "delete", "deletecollection", "get", "list", "patch", "update", "watch" ]
  }, {
    "categories" : [ "all" ],
    "kind" : "Service",
    "name" : "services",
    "namespaced" : true,
    "shortNames" : [ "svc" ],
    "singularName" : "",
    "verbs" : [ "create", "delete", "get", "list", "patch", "update", "watch" ]
  }, {
    "kind" : "Service",
    "name" : "services/status",
    "namespaced" : true,
    "singularName" : "",
    "verbs" : [ "get", "patch", "update" ]
  } ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

BadRequest

401

Unauthorized

403

Forbidden

404

NotFound

405

MethodNotAllowed

406

NotAcceptable

409

Conflict

415

UnsupportedMediaType

422

Invalid

429

TooManyRequests

500

InternalError

503

ServiceUnavailable

504

ServerTimeout