nittedal.no
niyodogawa.kochi.jp
nj.us
njs.jelastic.vps-host.net
nl
nl-ams-1.baremetal.scw.cloud
nl.ca
nl.eu.org
nl.no
nm.cn
nm.us
no
no-ip.biz
no-ip.ca
no-ip.co.uk
no-ip.info
no-ip.net
no-ip.org
no.eu.org
no.it
nobeoka.miyazaki.jp
noboribetsu.hokkaido.jp
nobushi.jp
noda.chiba.jp
noda.iwate.jp
nodes.k8s.fr-par.scw.cloud

Es gibt jedoch bestimmte Fälle, in denen es nützlich ist, auf das `Request`-Objekt zuzugreifen.

## Das `Request`-Objekt direkt verwenden { #use-the-request-object-directly }

Angenommen, Sie möchten auf die IP-Adresse/den Host des Clients in Ihrer *Pfadoperation-Funktion* zugreifen.

Dazu müssen Sie direkt auf den Request zugreifen.

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

Mas há situações específicas onde é útil utilizar o objeto `Request`.

## Utilize o objeto `Request` diretamente { #use-the-request-object-directly }

Vamos imaginar que você deseja obter o endereço de IP/host do cliente dentro da sua *função de operação de rota*.

Para isso você precisa acessar a requisição diretamente.

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

  or required. ([#124553](https://github.com/kubernetes/kubernetes/pull/124553), [@pmalek](https://github.com/pmalek))
- Fixed a 1.30.0 regression in openapi descriptions of `PodIP.IP`  and `HostIP.IP` fields to mark the fields used as keys in those lists as required. ([#126057](https://github.com/kubernetes/kubernetes/pull/126057), [@thockin](https://github.com/thockin))

不过，仍可以验证、转换与注释（使用 Pydantic 模型的请求体等）其它正常声明的参数。

但在某些特定情况下，还是需要提取 `Request` 对象。

## 直接使用 `Request` 对象 { #use-the-request-object-directly }

假设要在*路径操作函数*中获取客户端 IP 地址和主机。

此时，需要直接访问请求。

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

把*路径操作函数*的参数类型声明为 `Request`，**FastAPI** 就能把 `Request` 传递到参数里。

/// tip | 提示

注意，本例除了声明请求参数之外，还声明了路径参数。

不過，其他以一般方式宣告的參數（例如以 Pydantic 模型宣告的 body）仍然會被驗證、轉換、加上標註等。

但在某些特定情境下，直接取得 `Request` 物件會很實用。

## 直接使用 `Request` 物件 { #use-the-request-object-directly }

假設你想在你的 路徑操作函式（path operation function） 中取得用戶端的 IP 位址／主機。

為此，你需要直接存取請求。

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

只要在 路徑操作函式 中宣告一個型別為 `Request` 的參數，FastAPI 就會將當前的 `Request` 傳入該參數。

/// tip

Voici quelques combinaisons et stratégies possibles :

* **Uvicorn** avec `--workers`
    * Un **gestionnaire de processus** Uvicorn écouterait sur l'**IP** et le **port**, et il démarrerait **plusieurs processus workers Uvicorn**.

ただし、通常どおりに宣言された他のパラメータ（例: Pydantic モデルのボディ）は引き続き検証・変換・注釈付けなどが行われます。

それでも、`Request` オブジェクトを取得するのが有用な特定のケースがあります。

## `Request` オブジェクトを直接使う { #use-the-request-object-directly }

たとえば、path operation 関数内でクライアントの IP アドレス／ホストを取得したいとします。

そのためには、リクエストに直接アクセスする必要があります。

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}

path operation 関数の引数として `Request` 型のパラメータを宣言すると、**FastAPI** はその引数に `Request` を渡します。

pkg net, var ErrWriteToConnected error
pkg net, var IPv4allrouter IP
pkg net, var IPv4allsys IP
pkg net, var IPv4bcast IP
pkg net, var IPv4zero IP
pkg net, var IPv6interfacelocalallnodes IP
pkg net, var IPv6linklocalallnodes IP
pkg net, var IPv6linklocalallrouters IP
pkg net, var IPv6loopback IP
pkg net, var IPv6unspecified IP
pkg net, var IPv6zero IP
pkg net/http, const DefaultMaxHeaderBytes ideal-int

그러나 다른 매개변수(예: Pydantic 모델을 사용한 본문)는 여전히 검증, 변환, 주석 추가 등이 이루어집니다.

하지만 특정한 경우에는 `Request` 객체를 가져오는 것이 유용할 수 있습니다.

## `Request` 객체를 직접 사용하기 { #use-the-request-object-directly }

여러분이 클라이언트의 IP 주소/호스트 정보를 *경로 처리 함수* 내부에서 가져와야 한다고 가정해 보겠습니다.

이를 위해서는 요청에 직접 접근해야 합니다.

{* ../../docs_src/using_request_directly/tutorial001_py310.py hl[1,7:8] *}