15 KiB
Event v1
Group | Version | Kind |
---|---|---|
Core | v1 | Event |
Event is a report of an event somewhere in the cluster.
Field | Description |
---|---|
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: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources |
count integer |
The number of times this event has occurred. |
firstTimestamp Time |
The time at which the event was first recorded. (Time of server receipt is in TypeMeta.) |
involvedObject ObjectReference |
The object that this event is about. |
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: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds |
lastTimestamp Time |
The time at which the most recent occurrence of this event was recorded. |
message string |
A human-readable description of the status of this operation. |
metadata ObjectMeta |
Standard object's metadata. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata |
reason string |
This should be a short, machine understandable string that gives the reason for the transition into the object's current status. |
source EventSource |
The component reporting this event. Should be a short machine understandable string. |
type string |
Type of this event (Normal, Warning), new types could be added in the future |
EventList v1
Field | Description |
---|---|
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: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources |
items Event array |
List of events |
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: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds |
metadata ListMeta |
Standard list metadata. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds |
Write Operations
See supported operations below...
Create
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
create an Event
HTTP Request
POST /api/v1/namespaces/{namespace}/events
Path Parameters
Parameter | Description |
---|---|
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
pretty | If 'true', then the output is pretty printed. |
Body Parameters
Parameter | Description |
---|---|
body Event |
Response
Code | Description |
---|---|
200 Event |
OK |
Replace
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
replace the specified Event
HTTP Request
PUT /api/v1/namespaces/{namespace}/events/{name}
Path Parameters
Parameter | Description |
---|---|
name | name of the Event |
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
pretty | If 'true', then the output is pretty printed. |
Body Parameters
Parameter | Description |
---|---|
body Event |
Response
Code | Description |
---|---|
200 Event |
OK |
Patch
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
partially update the specified Event
HTTP Request
PATCH /api/v1/namespaces/{namespace}/events/{name}
Path Parameters
Parameter | Description |
---|---|
name | name of the Event |
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
pretty | If 'true', then the output is pretty printed. |
Body Parameters
Parameter | Description |
---|---|
body Patch |
Response
Code | Description |
---|---|
200 Event |
OK |
Delete
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
delete an Event
HTTP Request
DELETE /api/v1/namespaces/{namespace}/events/{name}
Path Parameters
Parameter | Description |
---|---|
name | name of the Event |
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
pretty | If 'true', then the output is pretty printed. |
gracePeriodSeconds | The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately. |
orphanDependents | Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the object's finalizers list. |
Body Parameters
Parameter | Description |
---|---|
body DeleteOptions |
Response
Code | Description |
---|---|
200 Status |
OK |
Delete Collection
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
delete collection of Event
HTTP Request
DELETE /api/v1/namespaces/{namespace}/events
Path Parameters
Parameter | Description |
---|---|
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
pretty | If 'true', then the output is pretty printed. |
fieldSelector | A selector to restrict the list of returned objects by their fields. Defaults to everything. |
labelSelector | A selector to restrict the list of returned objects by their labels. Defaults to everything. |
resourceVersion | 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 | Timeout for the list/watch call. |
watch | Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion. |
Response
Code | Description |
---|---|
200 Status |
OK |
Read Operations
See supported operations below...
Read
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
read the specified Event
HTTP Request
GET /api/v1/namespaces/{namespace}/events/{name}
Path Parameters
Parameter | Description |
---|---|
name | name of the Event |
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
pretty | If 'true', then the output is pretty printed. |
exact | Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace' |
export | Should this value be exported. Export strips fields that a user can not specify. |
Response
Code | Description |
---|---|
200 Event |
OK |
List
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
list or watch objects of kind Event
HTTP Request
GET /api/v1/namespaces/{namespace}/events
Path Parameters
Parameter | Description |
---|---|
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
pretty | If 'true', then the output is pretty printed. |
fieldSelector | A selector to restrict the list of returned objects by their fields. Defaults to everything. |
labelSelector | A selector to restrict the list of returned objects by their labels. Defaults to everything. |
resourceVersion | 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 | Timeout for the list/watch call. |
watch | Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion. |
Response
Code | Description |
---|---|
200 EventList |
OK |
List All Namespaces
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
list or watch objects of kind Event
HTTP Request
GET /api/v1/events
Query Parameters
Parameter | Description |
---|---|
fieldSelector | A selector to restrict the list of returned objects by their fields. Defaults to everything. |
labelSelector | A selector to restrict the list of returned objects by their labels. Defaults to everything. |
pretty | If 'true', then the output is pretty printed. |
resourceVersion | 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 | Timeout for the list/watch call. |
watch | Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion. |
Response
Code | Description |
---|---|
200 EventList |
OK |
Watch
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
watch changes to an object of kind Event
HTTP Request
GET /api/v1/watch/namespaces/{namespace}/events/{name}
Path Parameters
Parameter | Description |
---|---|
name | name of the Event |
namespace | object name and auth scope, such as for teams and projects |
Query Parameters
Parameter | Description |
---|---|
fieldSelector | A selector to restrict the list of returned objects by their fields. Defaults to everything. |
labelSelector | A selector to restrict the list of returned objects by their labels. Defaults to everything. |
pretty | If 'true', then the output is pretty printed. |
resourceVersion | 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 | Timeout for the list/watch call. |
watch | Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion. |
Response
Code | Description |
---|---|
200 Event |
OK |
Watch List All Namespaces
bdocs-tab:kubectl
kubectl
Command
Coming Soon
bdocs-tab:curl
curl
Command (requireskubectl proxy
to be running)
Coming Soon
bdocs-tab:kubectl Output
Coming Soon
bdocs-tab:curl Response Body
Coming Soon
watch individual changes to a list of Event
HTTP Request
GET /api/v1/watch/events
Query Parameters
Parameter | Description |
---|---|
fieldSelector | A selector to restrict the list of returned objects by their fields. Defaults to everything. |
labelSelector | A selector to restrict the list of returned objects by their labels. Defaults to everything. |
pretty | If 'true', then the output is pretty printed. |
resourceVersion | 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 | Timeout for the list/watch call. |
watch | Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion. |
Response
Code | Description |
---|---|
200 Event |
OK |