功能介绍
查询指定Network对象。
调用方法
请参见如何调用API。
URI
GET /apis/networking.cci.io/v1beta1/namespaces/{namespace}/networks/{name}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
name of the Network |
namespace |
是 |
String |
object name and auth scope, such as for teams and projects |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
exact |
否 |
Boolean |
Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'. Deprecated. Planned for removal in 1.18. |
export |
否 |
Boolean |
Should this value be exported. Export strips fields that a user can not specify. Deprecated. Planned for removal in 1.18. |
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 |
ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. |
|
spec |
Spec defines the attributes on a network |
|
status |
Status describes the network status |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
参数 |
参数类型 |
描述 |
---|---|---|
attachedVPC |
String |
ID of the VPC to attach |
availableZone |
String |
available zone |
cidr |
String |
The CIDR of the network |
networkID |
String |
network ID |
networkType |
String |
network type like 'overlay_l2' |
subnetID |
String |
Subnet ID |
subnets |
Subnets |
请求示例
无
响应示例
状态码: 200
OK
{
"apiVersion" : "networking.cci.io/v1beta1",
"kind" : "Network",
"metadata" : {
"annotations" : {
"network.alpha.kubernetes.io/default-security-group" : "19c5d024-aed5-4856-b958-c0f65ce70855",
"network.alpha.kubernetes.io/domain-id" : "aadb43c0b14c4cafbccfff483d075987",
"network.alpha.kubernetes.io/project-id" : "51bf52609f2a49c68bfda3398817b376"
},
"creationTimestamp" : "2018-09-03T11:21:00Z",
"name" : "namespace-test-dc1-default-network",
"namespace" : "namespace-test",
"resourceVersion" : "5016899",
"selfLink" : "/apis/networking.cci.io/v1beta1/namespaces/namespace-test/networks/namespace-test-dc1-default-network",
"uid" : "6fb85414-af6b-11e8-b6ef-f898ef6c78b4"
},
"spec" : {
"attachedVPC" : "0d4080e5-546a-46c4-86fe-f3e26d685177",
"availableZone" : "cn-north-4a",
"cidr" : "192.168.244.0/23",
"networkID" : "0022e356-f730-4226-802e-9cdaa6e7da17",
"networkType" : "underlay_neutron",
"subnetID" : "1ffd839d-e534-4fa8-a59d-42356335bf74"
},
"status" : {
"state" : "Active"
}
}
状态码
状态码 |
描述 |
---|---|
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 |