PipelineClient 클래스
서비스 클라이언트 핵심 메서드.
파이프라인 클라이언트를 빌드합니다.
- 상속
-
azure.core.pipeline.transport._base.PipelineClientBasePipelineClientPipelineClient
생성자
PipelineClient(base_url: str, *, pipeline: Pipeline[HTTPRequestType, HTTPResponseType] | None = None, config: Configuration[HTTPRequestType, HTTPResponseType] | None = None, **kwargs: Any)
매개 변수
- config
- Configuration
생략하면 표준 구성이 사용됩니다.
- pipeline
- Pipeline
생략하면 Pipeline 개체가 만들어지고 반환됩니다.
- policies
- list[HTTPPolicy]
생략하면 구성 개체의 표준 정책이 사용됩니다.
- per_call_policies
- Union[HTTPPolicy, SansIOHTTPPolicy, list[HTTPPolicy], list[SansIOHTTPPolicy]]
지정한 경우 정책은 RetryPolicy 전에 정책 목록에 추가됩니다.
- per_retry_policies
- Union[HTTPPolicy, SansIOHTTPPolicy, list[HTTPPolicy], list[SansIOHTTPPolicy]]
지정한 경우 정책은 RetryPolicy 이후 정책 목록에 추가됩니다.
- transport
- HttpTransport
생략하면 RequestsTransport가 동기 전송에 사용됩니다.
예제
파이프라인 클라이언트를 빌드합니다.
from azure.core import PipelineClient
from azure.core.rest import HttpRequest
from azure.core.pipeline.policies import RedirectPolicy, UserAgentPolicy
# example configuration with some policies
policies: Iterable[Union[HTTPPolicy, SansIOHTTPPolicy]] = [UserAgentPolicy("myuseragent"), RedirectPolicy()]
client: PipelineClient[HttpRequest, HttpResponse] = PipelineClient(base_url=url, policies=policies)
request = HttpRequest("GET", "https://bing.com")
pipeline_response = client._pipeline.run(request)
메서드
close | |
delete |
DELETE 요청 개체를 만듭니다. |
format_url |
제공된 URL이 이미 절대적이지 않은 경우 클라이언트 기본 URL을 사용하여 요청 URL의 서식을 지정합니다. 기본 URL과 템플릿 URL 모두 쿼리 매개 변수를 포함할 수 있습니다. |
get |
GET 요청 개체를 만듭니다. |
head |
HEAD 요청 개체를 만듭니다. |
merge |
MERGE 요청 개체를 만듭니다. |
options |
OPTIONS 요청 개체를 만듭니다. |
patch |
PATCH 요청 개체를 만듭니다. |
post |
POST 요청 개체를 만듭니다. |
put |
PUT 요청 개체를 만듭니다. |
send_request |
클라이언트의 연결된 정책을 통해 네트워크 요청을 실행하는 메서드입니다.
|
close
close() -> None
delete
DELETE 요청 개체를 만듭니다.
delete(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, content: Any = None, form_content: Dict[str, Any] | None = None) -> HttpRequest
매개 변수
반환
HttpRequest 개체
반환 형식
format_url
제공된 URL이 이미 절대적이지 않은 경우 클라이언트 기본 URL을 사용하여 요청 URL의 서식을 지정합니다.
기본 URL과 템플릿 URL 모두 쿼리 매개 변수를 포함할 수 있습니다.
format_url(url_template: str, **kwargs: Any) -> str
매개 변수
반환
서식이 지정된 URL입니다.
반환 형식
get
GET 요청 개체를 만듭니다.
get(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, content: Any = None, form_content: Dict[str, Any] | None = None) -> HttpRequest
매개 변수
반환
HttpRequest 개체
반환 형식
head
HEAD 요청 개체를 만듭니다.
head(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, content: Any = None, form_content: Dict[str, Any] | None = None, stream_content: Any = None) -> HttpRequest
매개 변수
- stream_content
- <xref:stream> 또는 <xref:generator> 또는 <xref:asyncgenerator>
스트림으로 본문 콘텐츠
반환
HttpRequest 개체
반환 형식
merge
MERGE 요청 개체를 만듭니다.
merge(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, content: Any = None, form_content: Dict[str, Any] | None = None) -> HttpRequest
매개 변수
반환
HttpRequest 개체
반환 형식
options
OPTIONS 요청 개체를 만듭니다.
options(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, *, content: bytes | str | Dict[Any, Any] | None = None, form_content: Dict[Any, Any] | None = None, **kwargs: Any) -> HttpRequest
매개 변수
- content
본문 내용
- form_content
- dict
양식 콘텐츠
반환
HttpRequest 개체
반환 형식
patch
PATCH 요청 개체를 만듭니다.
patch(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, content: Any = None, form_content: Dict[str, Any] | None = None, stream_content: Any = None) -> HttpRequest
매개 변수
- stream_content
- <xref:stream> 또는 <xref:generator> 또는 <xref:asyncgenerator>
스트림으로 본문 콘텐츠
반환
HttpRequest 개체
반환 형식
post
POST 요청 개체를 만듭니다.
post(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, content: Any = None, form_content: Dict[str, Any] | None = None, stream_content: Any = None) -> HttpRequest
매개 변수
- stream_content
- <xref:stream> 또는 <xref:generator> 또는 <xref:asyncgenerator>
스트림으로 본문 콘텐츠
반환
HttpRequest 개체
반환 형식
put
PUT 요청 개체를 만듭니다.
put(url: str, params: Dict[str, str] | None = None, headers: Dict[str, str] | None = None, content: Any = None, form_content: Dict[str, Any] | None = None, stream_content: Any = None) -> HttpRequest
매개 변수
- stream_content
- <xref:stream> 또는 <xref:generator> 또는 <xref:asyncgenerator>
스트림으로 본문 콘텐츠
반환
HttpRequest 개체
반환 형식
send_request
클라이언트의 연결된 정책을 통해 네트워크 요청을 실행하는 메서드입니다.
>>> from azure.core.rest import HttpRequest
>>> request = HttpRequest('GET', 'http://www.example.com')
<HttpRequest [GET], url: 'http://www.example.com'>
>>> response = client.send_request(request)
<HttpResponse: 200 OK>
send_request(request: HTTPRequestType, *, stream: bool = False, **kwargs: Any) -> HTTPResponseType
매개 변수
- stream
- bool
응답 페이로드가 스트리밍될지 여부입니다. 기본값은 False입니다.
반환
네트워크 호출의 응답입니다. 응답에 대한 오류 처리는 수행하지 않습니다.
반환 형식
Azure SDK for Python