功能介绍
查询Event详细信息。
调用方法
请参见如何调用API。
URI
GET /api/v1/namespaces/{namespace}/events/{name}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
name of the Event |
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
参数 |
参数类型 |
描述 |
---|---|---|
action |
String |
What action was taken/failed regarding to the Regarding object. |
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 |
count |
Integer |
The number of times this event has occurred. |
eventTime |
String |
Time when this Event was first observed. |
firstTimestamp |
String |
The time at which the event was first recorded. (Time of server receipt is in TypeMeta.) |
involvedObject |
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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
lastTimestamp |
String |
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 |
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/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. |
related |
Optional secondary object for more complex actions. |
|
reportingComponent |
String |
Name of the controller that emitted this Event, e.g. kubernetes.io/kubelet. |
reportingInstance |
String |
ID of the controller instance, e.g. kubelet-xyzf. |
series |
Data about the Event series this event represents or nil if it's a singleton Event. |
|
source |
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 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
参数 |
参数类型 |
描述 |
---|---|---|
apiVersion |
String |
API version of the referent. |
fieldPath |
String |
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. |
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: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
namespace |
String |
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
resourceVersion |
String |
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
uid |
String |
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
请求示例
无
响应示例
状态码: 200
OK
{
"apiVersion" : "v1",
"count" : 1,
"eventTime" : null,
"firstTimestamp" : "2018-09-03T12:58:07Z",
"involvedObject" : {
"apiVersion" : "v1",
"kind" : "Pod",
"name" : "deployment-test-57f7cff77c-5x5tw",
"namespace" : "namespace-test",
"resourceVersion" : "5036865",
"uid" : "010fec39-af79-11e8-8f17-c81fbe371a17"
},
"kind" : "Event",
"lastTimestamp" : "2018-09-03T12:58:07Z",
"message" : "Successfully assigned deployment-test-57f7cff77c-5x5tw to c0dd6256-195a-e811-90a2-10c17294fcbc",
"metadata" : {
"creationTimestamp" : "2018-09-03T12:58:07Z",
"name" : "deployment-test-57f7cff77c-5x5tw.1550e534d2d8a5ef",
"namespace" : "namespace-test",
"resourceVersion" : "760533",
"selfLink" : "/api/v1/namespaces/namespace-test/events/deployment-test-57f7cff77c-5x5tw.1550e534d2d8a5ef",
"uid" : "0122b5b2-af79-11e8-8f17-c81fbe371a17"
},
"reason" : "Scheduled",
"reportingComponent" : "",
"reportingInstance" : "",
"source" : {
"component" : "default-scheduler"
},
"type" : "Normal"
}
状态码
状态码 |
描述 |
---|---|
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 |