功能介绍
查询指定的EIPPool的详细信息。
调用方法
请参见如何调用API。
URI
GET /apis/crd.yangtse.cni/v1/namespaces/{namespace}/eippools/{name}
| 
 参数  | 
 是否必选  | 
 参数类型  | 
 描述  | 
|---|---|---|---|
| 
 name  | 
 是  | 
 String  | 
 name of the EIPPool  | 
| 
 namespace  | 
 是  | 
 String  | 
 object name and auth scope, such as for teams and projects  | 
| 
 参数  | 
 是否必选  | 
 参数类型  | 
 描述  | 
|---|---|---|---|
| 
 resourceVersion  | 
 否  | 
 String  | 
 resourceVersion sets a constraint on what resource versions a request may be served from. See https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions for details. Defaults to unset  | 
| 
 pretty  | 
 否  | 
 String  | 
 If 'true', then the output is pretty printed.  | 
请求参数
| 
 参数  | 
 是否必选  | 
 参数类型  | 
 描述  | 
|---|---|---|---|
| 
 X-Auth-Token  | 
 是  | 
 String  | 
 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。  | 
响应参数
状态码: 200
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 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  | 
| 
 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  | 
| 
 metadata  | 
 Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata  | 
|
| 
 spec  | 
 Specification of the EIPPool.  | 
|
| 
 status  | 
 Status of the EIPPool.  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 apiVersion  | 
 String  | 
 APIVersion defines the version of this resource that this field set applies to. The format is "group/version" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.  | 
| 
 fieldsType  | 
 String  | 
 FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: "FieldsV1"  | 
| 
 fieldsV1  | 
 Object  | 
 FieldsV1 holds the first JSON version format as described in the "FieldsV1" type.  | 
| 
 manager  | 
 String  | 
 Manager is an identifier of the workflow managing these fields.  | 
| 
 operation  | 
 String  | 
 Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.  | 
| 
 time  | 
 String  | 
 Time is timestamp of when these fields were set. It should always be empty if Operation is 'Apply'  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 apiVersion  | 
 String  | 
 API version of the referent.  | 
| 
 blockOwnerDeletion  | 
 Boolean  | 
 If true, AND if the owner has the "foregroundDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. Defaults to false. To set this field, a user needs "delete" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.  | 
| 
 controller  | 
 Boolean  | 
 If true, this reference points to the managing controller.  | 
| 
 kind  | 
 String  | 
 Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds  | 
| 
 name  | 
 String  | 
 Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names  | 
| 
 uid  | 
 String  | 
 UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 amount  | 
 Integer  | 
 Amount is the amount of eips need to be create. 最小值:0 最大值:500  | 
| 
 eipAttributes  | 
 Attributes is the eip attributes which used to create eip.  | 
|
| 
 eips  | 
 Array of strings  | 
 EIPs used to generate EIP resources.  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 alias  | 
 String  | 
 Alias of PublicIP  | 
| 
 bandwidth  | 
 Bandwidth create attributes  | 
|
| 
 ipVersion  | 
 Integer  | 
 IP Version of PublicIP 枚举值: 
  | 
| 
 networkType  | 
 String  | 
 Network Type of PublicIP  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 chargeMode  | 
 String  | 
 Bandwidth Charge Mode 枚举值: 
  | 
| 
 id  | 
 String  | 
 Bandwidth id, only useful for WHOLE bandwidth share type  | 
| 
 name  | 
 String  | 
 Bandwidth name, only useful for PER bandwidth share type 最小长度:1 最大长度:64  | 
| 
 shareType  | 
 String  | 
 Bandwidth Share Type 枚举值: 
  | 
| 
 size  | 
 Integer  | 
 Bandwidth size 最小值:0 最大值:200000  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 associates  | 
 eip associate infos.  | 
|
| 
 eips  | 
 EIPs is a set of generated EIP resources.  | 
|
| 
 usage  | 
 String  | 
 Usage is usage of eip in this pool, e.g. 2/10.  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 attachment  | 
 Attachment is the eip attachment info.  | 
|
| 
 privateIP  | 
 PrivateIP is private ip information  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 freeTimestamp  | 
 String  | 
 Timestamp of NeutronPort be to FixedPreBound or FixedUnBound phase  | 
| 
 neutronPortName  | 
 String  | 
 NeutronPortName is NeutronPort name which associated.  | 
| 
 neutronPortNamespace  | 
 String  | 
 NeutronPortNamespace is NeutronPort namespace which associated.  | 
| 
 nodeName  | 
 String  | 
 NodeName is node name where the NeutronPort resides, must with phase Bound, PreBound or FixedBound.  | 
| 
 podName  | 
 String  | 
 Pod name  | 
| 
 podNamespace  | 
 String  | 
 Pod Namespace  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 id  | 
 String  | 
 Port ID or EIP ID  | 
| 
 ipv4  | 
 String  | 
 IPv4 is the IPv4 address for traffic from the eni.  | 
| 
 ipv6  | 
 String  | 
 IPv6 is the IPv6 address for traffic from the eni.  | 
| 
 mac  | 
 String  | 
 MAC is the MAC address of the endpoint interface.  | 
| 
 status  | 
 String  | 
 Status of this IP  | 
| 
 参数  | 
 参数类型  | 
 描述  | 
|---|---|---|
| 
 alias  | 
 String  | 
 Alias of the PublicIP  | 
| 
 associateInstanceID  | 
 String  | 
 Associate instance id  | 
| 
 associateInstanceType  | 
 String  | 
 Associate instance type  | 
| 
 bandWidthChargeMode  | 
 String  | 
 Bandwidth charge mode of the PublicIP  | 
| 
 bandwidthShareType  | 
 String  | 
 Bandwidth share type of the PublicIP  | 
| 
 bandwidthSize  | 
 Integer  | 
 Bandwidth size of the PublicIP  | 
| 
 id  | 
 String  | 
 The ID of the PublicIP  | 
| 
 ipv4  | 
 String  | 
 The ipv4 address of the PublicIP  | 
| 
 ipv6  | 
 String  | 
 The ipv6 address of the PublicIP  | 
| 
 networkType  | 
 String  | 
 Network Type of PublicIP  | 
| 
 status  | 
 String  | 
 PublicIP status  | 
请求示例
无
响应示例
状态码: 200
OK
{
  "apiVersion" : "crd.yangtse.cni/v1",
  "kind" : "EIPPool",
  "metadata" : {
    "creationTimestamp" : "2022-09-07T01:22:50Z",
    "finalizers" : [ "yangtse.io/eip-pool" ],
    "generation" : 1,
    "name" : "eippool-test",
    "namespace" : "namespace-test",
    "resourceVersion" : "42396258",
    "selfLink" : "/apis/crd.yangtse.cni/v1/namespaces/namespace-test/eippools/eippool-test",
    "uid" : "e4dc5432-1d9b-4fcb-8840-ee445b6511ae"
  },
  "spec" : {
    "amount" : 1,
    "eipAttributes" : {
      "bandwidth" : {
        "chargeMode" : "bandwidth",
        "name" : "eip-test",
        "shareType" : "PER",
        "size" : 5
      },
      "ipVersion" : 4,
      "networkType" : "5_g-vm"
    }
  },
  "status" : {
    "eips" : [ {
      "alias" : "eip-test",
      "bandWidthChargeMode" : "bandwidth",
      "bandwidthShareType" : "PER",
      "bandwidthSize" : 5,
      "id" : "034a0bae-81f7-46f4-b933-3273adc32b54",
      "ipv4" : "100.85.221.2",
      "networkType" : "5_g-vm",
      "status" : "DOWN"
    } ],
    "usage" : "0/1"
  }
}
状态码
| 
 状态码  | 
 描述  | 
|---|---|
| 
 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  | 
  
    