website/content/zh-cn/docs/reference/kubernetes-api/common-definitions/object-reference.md

99 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
api_metadata:
apiVersion: ""
import: "k8s.io/api/core/v1"
kind: "ObjectReference"
content_type: "api_reference"
description: "ObjectReference 包含足够的信息,可以让你检查或修改引用的对象。"
title: "ObjectReference"
weight: 8
---
<!--
api_metadata:
apiVersion: ""
import: "k8s.io/api/core/v1"
kind: "ObjectReference"
content_type: "api_reference"
description: "ObjectReference contains enough information to let you inspect or modify the referred object."
title: "ObjectReference"
weight: 8
auto_generated: true
-->
`import "k8s.io/api/core/v1"`
<!--
ObjectReference contains enough information to let you inspect or modify the referred object.
-->
ObjectReference 包含足够的信息,允许你检查或修改引用的对象。
<hr>
<!--
- **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.
-->
- **apiVersion** (string)
被引用者的 API 版本。
- **fieldPath** (string)
如果引用的是对象的某个对象是整个对象,则该字符串而不是应包含的 JSON/Go 字段有效访问语句,
例如 `desiredState.manifest.containers[ 2 ]`。例如,如果对象引用针对的是 Pod 中的一个容器,
此字段取值类似于:`spec.containers{name}``name` 指触发的容器的名称),
或者如果没有指定容器名称,`spec.containers[ 2 ]`(此 Pod 中索引为 2 的容器)。
选择这种只是为了有一些定义好的语法来引用对象的部分。
<!--
- **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/
-->
- **kind** (string)
被引用者的类别kind。更多信息
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
- **name** (string)
被引用对象的名称。更多信息:
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/names/#names
- **namespace** (string)
被引用对象的名字空间。更多信息:
https://kubernetes.io/zh-cn/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
-->
- **resourceVersion** (string)
被引用对象的特定资源版本(如果有)。更多信息:
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
- **uid** (string)
被引用对象的 UID。更多信息
https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/names/#uids