古いバージョンの場合、`Annotated`を使おうとするとエラーになります。

`Annotated`を使用する前に、FastAPI のバージョンを少なくとも 0.95.1 まで[アップグレードしてください](../deployment/versions.md#upgrading-the-fastapi-versions)。

///

## メタデータの宣言 { #declare-metadata }

パラメータは`Query`と同じものを宣言することができます。

例えば、パスパラメータ`item_id`に対して`title`のメタデータを宣言するには以下のようにします:

{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[10] *}

/// note | 備考

        byte[] serialized1 = serializer.fromObjectToBinary(original);
        byte[] serialized2 = serializer.fromObjectToBinary(original);

        // Note: Serialized bytes may not be identical due to metadata,
        // but deserialization should produce the same result
        Object deserialized1 = serializer.fromBinaryToObject(serialized1);
        Object deserialized2 = serializer.fromBinaryToObject(serialized2);

///

## `q` パラメータの型で `Annotated` を使う { #use-annotated-in-the-type-for-the-q-parameter }

以前、[Python Types Intro](../python-types.md#type-hints-with-metadata-annotations) で `Annotated` を使ってパラメータにメタデータを追加できると説明したことを覚えていますか？

いよいよ FastAPI で使うときです。 🚀

次の型アノテーションがありました:

```Python
q: str | None = None
```

これを `Annotated` で包んで、次のようにします:

```Python

/// info | 資訊

想了解更多 [Pydantic，請查看它的文件](https://docs.pydantic.dev/)。

///

**FastAPI** 完全是以 Pydantic 為基礎。

你會在[教學 - 使用者指南](tutorial/index.md)中看到更多實際範例。

## 含中繼資料的型別提示 { #type-hints-with-metadata-annotations }

Python 也有一個功能，允許使用 `Annotated` 在這些型別提示中放入額外的<dfn title="關於資料的資料；在此情境下，是關於型別的資訊，例如描述。">中繼資料</dfn>。

你可以從 `typing` 匯入 `Annotated`。

{* ../../docs_src/python_types/tutorial013_py310.py hl[1,4] *}

     * Also processes permissions and virtual hosts from form fields.
     *
     * @param form the form containing the web config data
     * @return an optional WebConfig entity with updated metadata
     */
    public static OptionalEntity<WebConfig> getWebConfig(final CreateForm form) {
        final SystemHelper systemHelper = ComponentUtil.getSystemHelper();
        final String username = systemHelper.getUsername();

* Fix logrotate config on GCI ([#29139](https://github.com/kubernetes/kubernetes/pull/29139), [@adityakali](https://github.com/adityakali))
* Do not query the metadata server to find out if running on GCE.  Retry metadata server query for gcr if running on gce. ([#28871](https://github.com/kubernetes/kubernetes/pull/28871), [@vishh](https://github.com/vishh))

        });
    }

    /**
     * Gets the action response for the specified SSO response type.
     *
     * SPNEGO authentication typically doesn't require special response handling
     * for metadata or logout operations, so this method returns null.
     *
     * @param responseType The type of SSO response requested
     * @return Always returns null for SPNEGO authentication
     */
    @Override

		xioutil.SafeClose(resp)
		return err
	}
	defer done(0, &err)

	return p.storage.ReadMultiple(ctx, req, resp)
}

// CleanAbandonedData will read metadata of the object on disk
// and delete any data directories and inline data that isn't referenced in metadata.
func (p *xlStorageDiskIDCheck) CleanAbandonedData(ctx context.Context, volume string, path string) (err error) {

TF_CAPI_EXPORT extern void TFE_ContextDisableRunMetadata(TFE_Context* ctx);

// Populates the passed-in buffer with a serialized RunMetadata protocol buffer
// containing any run metadata information accumulated so far and clears this
// information.
// If async mode is enabled, this call blocks till all currently pending ops are
// done.

/// info | 信息

想了解更多关于 [Pydantic](https://docs.pydantic.dev/) 的信息，请查看其文档。

///

**FastAPI** 完全建立在 Pydantic 之上。

你会在[教程 - 用户指南](tutorial/index.md)中看到更多的实战示例。

## 带元数据注解的类型提示 { #type-hints-with-metadata-annotations }

Python 还提供了一个特性，可以使用 `Annotated` 在这些类型提示中放入额外的<dfn title="关于数据的数据，此处指关于类型的信息，例如描述。">元数据</dfn>。

你可以从 `typing` 导入 `Annotated`。

{* ../../docs_src/python_types/tutorial013_py310.py hl[1,4] *}