IPAddress
apiVersion: networking.k8s.io/v1
import "k8s.io/api/networking/v1"
IPAddress
IPAddress represents a single IP of a single IP Family. The object is designed to be used by APIs that operate on IP addresses. The object is used by the Service core API for allocation of IP addresses. An IP address can be represented in different formats, to guarantee the uniqueness of the IP, the name of the object is the IP address in canonical format, four decimal digits separated by dots suppressing leading zeros for IPv4 and the representation defined by RFC 5952 for IPv6. Valid: 192.168.1.5 or 2001:db8::1 or 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Invalid: 10.01.2.3 or 2001:db8:0:0:0::1
apiVersion: networking.k8s.io/v1
kind: IPAddress
-
metadata (ObjectMeta)
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-
spec (IPAddressSpec)
spec is the desired state of the IPAddress. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
IPAddressSpec
IPAddressSpec describe the attributes in an IP Address.
-
parentRef (ParentReference), required
ParentRef references the resource that an IPAddress is attached to. An IPAddress must reference a parent object.
ParentReference describes a reference to a parent object.
-
parentRef.name (string), required
Name is the name of the object being referenced.
-
parentRef.resource (string), required
Resource is the resource of the object being referenced.
-
parentRef.group (string)
Group is the group of the object being referenced.
-
parentRef.namespace (string)
Namespace is the namespace of the object being referenced.
-
IPAddressList
IPAddressList contains a list of IPAddress.
apiVersion: networking.k8s.io/v1
kind: IPAddressList
-
metadata (ListMeta)
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-
items ([]IPAddress), required
items is the list of IPAddresses.
© 2025 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2025 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/cluster-resources/ip-address-v1/