查看项目列表
请求信息
请求行
GET /apis/auth.alauda.io/v1/projects
查看类型为 Project 的资源对象的列表。
请求参数
| 名称 | 类型 | 是否必填项 | 描述 |
|---|---|---|---|
| allowWatchBookmarks | boolean | 否 | allowWatchBookmarks 请求使用 BOOKMARK 类型监视事件。没有实现书签的服务器可能会忽略此标志，而书签是由服务器自行发送的。客户端不应该假定书签在任何特定的间隔被返回，也不应该假定服务器将在会话期间发送任何 BOOKMARK 事件。如果这不是 watch 请求，这个字段将被忽略。如果在 apiserver 中未启用特性门 WatchBookmarks，则忽略该字段。 |
| continue | string | 否 | 服务器定义的值，⽤于从服务器中查询更多的返回结果。客户端只能从上⼀个查询结果中获取该值。当查询列表时设置了limit 参数，返回结果未包含服务器上可以查询到的所有数据，此时，会返回 continue 参数，并为 continue 参数赋值⼀个 Token。需要查询更多返回结果时，可将 continue 参数及其值作为查询参数查询更多结果。说明：如果列表配置发⽣变化或查询过期，输⼊此查询参数后，会返回 410 错误码，如果继续输⼊该查询参数进⾏查询，返回的查询结果可能不是最新的数据。 |
| fieldSelector | string | 否 | 字段选择器，可通过资源对象的字段过滤、筛选资源对象，默认返回所有资源对象。 |
| labelSelector | string | 否 | 标签选择器，可通过标签过滤、筛选资源对象，默认返回所有资源对象。 |
| limit | integer | 否 | limit 是查询列表请求返回的最大响应数。 如果存在更多项，则服务器会将列表元数据上的 “continue” 字段设置为一个值，该值可与相同的初始查询一起使用用来检索下一组结果。如果所有请求的对象都被过滤掉了，则设置的限制返回的项目数可能少于请求的项目数（最多为零），并且客户端应仅使用 continue 字段的存在来确定是否有更多结果可用。服务器可能选择不支持 limit 参数，并将返回所有可用结果。如果指定了限制，并且 continue 字段为空，则客户端可能会认为没有更多结果可用。如果 watch 为 true，则不支持此字段。 服务器保证使用 continue 时返回的对象与发出单个列表调用无限制地相同，也就是说，在发出第一个请求后，任何创建、修改或删除的对象都不会包含在任何后续的继续请求中。有时这被称为一致快照，并确保使用限制接收非常大结果的较小块的客户端可以确保它们看到所有可能的对象。如果在分块列表期间更新对象，则将返回在计算第一个列表结果时存在的对象版本。 |
| resourceVersion | string | 否 | 当指定使用 watch 请求时，将显示在资源的特定版本之后发生的更改。默认从历史开始更改。当为 list 指定时：-如果未设置，则基于 quora -read 标志从远程存储返回结果；-如果它是 0，那么我们只是返回我们目前在缓存，没有保证；-如果设置为非零，那么结果至少与给定的 resourceVersion 一样为最新的值。 |
| timeoutSeconds | integer | 否 | list/watch 方法的调用超时时长。这限制了调用的持续时间，不管是否活跃。 |
| watch | boolean | 否 | 监视对所描述的资源的更改，并将其作为添加、更新和删除通知的流返回。需要指定 resourceVersion。 |
| pretty | string | 否 | 如果为 true，则会将返回结果输出成适合打印的格式。 |
返回信息
Content-Type
application/json,
application/yaml
状态码: 200
OK
返回体示例
项目列表。
{
"apiVersion": "auth.alauda.io/v1",
"items": [
{
"apiVersion": "auth.alauda.io/v1",
"kind": "Project",
"metadata": {
"annotations": {
"cpaas.io/creator": "admin@cpaas.io",
"cpaas.io/description": "cpaas",
"cpaas.io/display-name": "cpaas",
"cpaas.io/unite-quota-fed-clusters": "",
"cpaas.io/updated-at": "2021-06-28T03:34:24Z"
},
"creationTimestamp": "2021-06-28T03:34:24Z",
"finalizers": [
"namespace"
],
"generation": 2,
"labels": {
"cpaas.io/project": "cpaas",
"cpaas.io/project.id": "114038197",
"cpaas.io/project.level": "1",
"cpaas.io/project.parent": ""
},
"name": "cpaas",
"resourceVersion": "41289584",
"selfLink": "/apis/auth.alauda.io/v1/projects/cpaas",
"uid": "9733309c-695e-4ea2-b2a4-8f96fd24ada1"
},
"spec": {
"clusters": [
{
"name": "global",
"quota": {
"limits.cpu": "5",
"limits.memory": "5Gi",
"persistentvolumeclaims": "5",
"pods": "5",
"requests.cpu": "5",
"requests.memory": "5Gi",
"requests.storage": "5Gi"
},
"type": ""
}
]
},
"status": {
"phase": "Active",
"version": "331f49118708aa89d6804ee90a5321d7"
}
}
],
"kind": "ProjectList",
"metadata": {
"continue": "",
"resourceVersion": "41390751",
"selfLink": "/apis/auth.alauda.io/v1/projects"
}
}返回体说明
| 名称 | 类型 | 描述 |
|---|---|---|
| apiVersion | string | 查看公共参数 |
| items | array |
List of projects. 更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md
字段路径：items |
| items[] | object |
字段路径：items[] |
| items[].apiVersion | string | 查看公共参数 |
| items[].kind | string | 查看公共参数 |
| items[].metadata | object | 查看公共参数 |
| items[].spec | object |
Spec 是项目的描述。有可能是被活跃的控制器协调的。
字段路径：items[].spec |
| spec.clusters | array |
和项目关联的集群。
字段路径：items[].spec.clusters |
| spec.clusters[] | object |
集群列表。
字段路径：items[].spec.clusters[] |
| clusters[].name | string |
集群名称。
字段路径：items[].spec.clusters[].name |
| clusters[].quota | object |
项目的配额信息。
字段路径：items[].spec.clusters[].quota |
| clusters[].type | string |
集群的类型。
字段路径：items[].spec.clusters[].type |
| items[].status | object |
项目的状态信息。
字段路径：items[].status |
| status.phase | string |
Phase 记录了项目的状态。
字段路径：items[].status.phase |
| kind | string | 查看公共参数 |
| metadata | object | 查看公共参数 |