文档首页 > > API参考> Kubernetes API> Service> 列出Service

列出Service

分享
更新时间:2020/05/26 GMT+08:00

功能介绍

该API用于获取集群中的Service列表。

URI

GET /api/v1/services

表1 描述该API的参数。

表1 参数描述

参数

是否必选

描述

pretty

No

If 'true', then the output is pretty printed.

labelSelector

No

A selector to restrict the list of returned objects by their labels. Defaults to everything.

fieldSelector

No

A selector to restrict the list of returned objects by their fields. Defaults to everything.

watch

No

Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

resourceVersion

No

When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history.

timeoutSeconds

No

Timeout for the list/watch call.

includeUninitialized

No

If true, partially initialized resources are included in the response.

请求消息

N/A

响应消息

响应参数:

响应参数的详细描述请参见表2

响应示例:

{ 
   "kind": "ServiceList", 
   "apiVersion": "v1", 
   "metadata": { 
     "selfLink": "/api/v1/services", 
     "resourceVersion": "1244" 
   }, 
   "items": [ 
     { 
       "metadata": { 
         "name": "kubernetes", 
         "namespace": "default", 
         "selfLink": "/api/v1/namespaces/default/services/kubernetes", 
         "uid": "a50a2352-5d0b-11e6-aeb9-286ed488fafe", 
         "resourceVersion": "8", 
         "creationTimestamp": "2016-08-08T01:58:47Z", 
         "labels": { 
           "component": "apiserver", 
           "provider": "kubernetes" 
         } 
       }, 
       "spec": { 
         "ports": [ 
           { 
             "name": "https", 
             "protocol": "TCP", 
             "port": 443, 
             "targetPort": 443 
           } 
         ], 
         "clusterIP": "10.0.0.1", 
         "type": "ClusterIP", 
         "sessionAffinity": "None" 
       }, 
       "status": { 
         "loadBalancer": {} 
       } 
     }, 
     { 
       "metadata": { 
         "name": "myapp", 
         "namespace": "default", 
         "selfLink": "/api/v1/namespaces/default/services/myapp", 
         "uid": "58b5ca7c-5d12-11e6-aeb9-286ed488fafe", 
         "resourceVersion": "1204", 
         "creationTimestamp": "2016-08-08T02:46:46Z" 
       }, 
       "spec": { 
         "ports": [ 
           { 
             "protocol": "TCP", 
             "port": 80, 
             "targetPort": 80 
           } 
         ], 
         "selector": { 
           "app": "example" 
         }, 
         "clusterIP": "10.0.0.139", 
         "type": "ClusterIP", 
         "sessionAffinity": "None" 
       }, 
       "status": { 
         "loadBalancer": {} 
       } 
     } 
   ] 
 }

状态码

表2描述API的状态码。

表2 状态码

状态码

描述

200

This operation succeeds, and a group of Service resource objects is returned.

异常状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问