RequestPrepareOptions interface
나가는 HTTP 요청을 준비하는 옵션입니다.
속성
abort |
중단 컨트롤러의 신호입니다. 네트워크 요청을 보내고 응답을 기다리는 것을 모두 중단하는 데 사용할 수 있습니다. |
base |
요청의 기본 URL입니다. 기본값은 "https://management.azure.com"입니다. pathTemplate에만 적용됩니다. options.url을 제공하는 경우 전체 URL을 제공해야 합니다. |
body | 요청 본문. 모든 형식일 수 있습니다. 이 값은 스트림이 아닌 경우 직렬화됩니다. |
body |
요청 본문이 스트림인지 여부를 나타냅니다(파일 업로드 시나리오에 유용). |
deserialization |
응답 본문을 역직렬화하는 방법에 대한 정보를 제공합니다. |
disable |
true로 설정하면 클라이언트가 "x-ms-client-request-id" 헤더를 새 Guid()로 설정하지 않도록 지시합니다. |
disable |
이 메서드가 요청 본문을 JSON.stringify()해야 하는지 여부를 나타냅니다. 기본값: false |
form |
요청 본문을 빌드하는 데 사용되는 양식 데이터입니다. |
headers | 요청에 적용해야 하는 요청 헤더의 사전입니다. 여기서 키는 "header-name"이고 값은 "header-value"입니다. 헤더-값은 문자열 형식이어야 합니다.
|
mappers | [de]serialization 동안 사용할 수 있는 매퍼 사전입니다. |
method | HTTP 요청 메서드입니다. 유효한 값은 "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" 또는 "PATCH"입니다. |
on |
들어오는 응답을 다운로드하는 진행률을 추적할 수 있습니다. |
on |
나가는 요청을 업로드하는 진행률을 추적할 수 있습니다. |
path |
pathTemplate의 실제 값으로 바꿔야 하는 경로 매개 변수의 사전입니다. 여기서 키는 "path-parameter-name"이고 값은 "path-parameter-value"입니다. "path-parameter-value"는 "string" 형식이거나 "object" 형식일 수 있습니다. URL 인코딩을 건너뛰려는 경우 "개체" 형식을 사용해야 합니다. 개체 형식을 사용하는 동안 개체에는 "path-parameter-value"를 제공하는 값이라는 속성이 있어야 합니다. 예제:
|
path |
요청 URL의 경로 템플릿입니다. 옵션 개체에 "url"을 제공하거나 "pathTemplate"을 제공합니다. 두 옵션은 모두 함께 사용할 수 없습니다.
예: |
query |
URL에 추가할 쿼리 매개 변수 사전입니다. 여기서 "key"는 "query-parameter-name"이고 "value"는 "query-parameter-value"입니다. "query-parameter-value"는 "string" 형식이거나 "object" 형식일 수 있습니다. URL 인코딩을 건너뛰려는 경우 "개체" 형식을 사용해야 합니다. 개체 형식을 사용하는 동안 개체에는 "query-parameter-value"를 제공하는 값이라는 속성이 있어야 합니다. 예제:
|
serialization |
요청 본문을 직렬화하는 방법에 대한 정보를 제공합니다. |
span |
추적: 추적을 사용할 때 범위를 만드는 데 사용되는 옵션입니다. |
tracing |
추적: 범위를 만들 때 사용되는 컨텍스트입니다. |
url | 요청 URL입니다. 쿼리 매개 변수가 있을 수도 있고 없을 수도 있습니다. 옵션 개체에 "url"을 제공하거나 "pathTemplate"을 제공합니다. 두 옵션은 모두 함께 사용할 수 없습니다. |
속성 세부 정보
abortSignal
중단 컨트롤러의 신호입니다. 네트워크 요청을 보내고 응답을 기다리는 것을 모두 중단하는 데 사용할 수 있습니다.
abortSignal?: AbortSignalLike
속성 값
baseUrl
요청의 기본 URL입니다. 기본값은 "https://management.azure.com"입니다. pathTemplate에만 적용됩니다. options.url을 제공하는 경우 전체 URL을 제공해야 합니다.
baseUrl?: string
속성 값
string
body
요청 본문. 모든 형식일 수 있습니다. 이 값은 스트림이 아닌 경우 직렬화됩니다.
body?: any
속성 값
any
bodyIsStream
요청 본문이 스트림인지 여부를 나타냅니다(파일 업로드 시나리오에 유용).
bodyIsStream?: boolean
속성 값
boolean
deserializationMapper
응답 본문을 역직렬화하는 방법에 대한 정보를 제공합니다.
deserializationMapper?: Record<string, unknown>
속성 값
Record<string, unknown>
disableClientRequestId
true로 설정하면 클라이언트가 "x-ms-client-request-id" 헤더를 새 Guid()로 설정하지 않도록 지시합니다.
disableClientRequestId?: boolean
속성 값
boolean
disableJsonStringifyOnBody
이 메서드가 요청 본문을 JSON.stringify()해야 하는지 여부를 나타냅니다. 기본값: false
disableJsonStringifyOnBody?: boolean
속성 값
boolean
formData
요청 본문을 빌드하는 데 사용되는 양식 데이터입니다.
formData?: {[key: string]: any}
속성 값
{[key: string]: any}
headers
요청에 적용해야 하는 요청 헤더의 사전입니다. 여기서 키는 "header-name"이고 값은 "header-value"입니다. 헤더-값은 문자열 형식이어야 합니다.
- ContentType은 키 이름을 "Content-Type"으로 제공해야 합니다. 기본값 "application/json; charset=utf-8".
- "options.bodyIsStream"이 true로 설정된 경우 "Transfer-Encoding"은 기본적으로 "청크"로 설정됩니다.
- "options.bodyIsStream"이 true로 설정된 경우 "Content-Type"은 기본적으로 "application/octet-stream"으로 설정됩니다.
- 기본적으로 "accept-language"는 "en-US"로 설정됩니다.
- 기본적으로 "x-ms-client-request-id"는 새 Guid로 설정됩니다. 요청에 대한 GUID를 생성하지 않으려면 options.disableClientRequestId를 true로 설정하세요.
headers?: {[key: string]: any}
속성 값
{[key: string]: any}
mappers
[de]serialization 동안 사용할 수 있는 매퍼 사전입니다.
mappers?: {[x: string]: any}
속성 값
{[x: string]: any}
method
HTTP 요청 메서드입니다. 유효한 값은 "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" 또는 "PATCH"입니다.
method: HttpMethods
속성 값
onDownloadProgress
들어오는 응답을 다운로드하는 진행률을 추적할 수 있습니다.
onDownloadProgress?: (progress: TransferProgressEvent) => void
속성 값
(progress: TransferProgressEvent) => void
onUploadProgress
나가는 요청을 업로드하는 진행률을 추적할 수 있습니다.
onUploadProgress?: (progress: TransferProgressEvent) => void
속성 값
(progress: TransferProgressEvent) => void
pathParameters
pathTemplate의 실제 값으로 바꿔야 하는 경로 매개 변수의 사전입니다. 여기서 키는 "path-parameter-name"이고 값은 "path-parameter-value"입니다. "path-parameter-value"는 "string" 형식이거나 "object" 형식일 수 있습니다. URL 인코딩을 건너뛰려는 경우 "개체" 형식을 사용해야 합니다. 개체 형식을 사용하는 동안 개체에는 "path-parameter-value"를 제공하는 값이라는 속성이 있어야 합니다. 예제:
- path-parameter-value("object" 형식):
{ "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true } }
- "string" 형식의 path-parameter-value:
{ "path-parameter-name": "path-parameter-value" }
.
pathParameters?: {[key: string]: any | ParameterValue}
속성 값
{[key: string]: any | ParameterValue}
pathTemplate
요청 URL의 경로 템플릿입니다. 옵션 개체에 "url"을 제공하거나 "pathTemplate"을 제공합니다. 두 옵션은 모두 함께 사용할 수 없습니다.
예: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}
pathTemplate?: string
속성 값
string
queryParameters
URL에 추가할 쿼리 매개 변수 사전입니다. 여기서 "key"는 "query-parameter-name"이고 "value"는 "query-parameter-value"입니다. "query-parameter-value"는 "string" 형식이거나 "object" 형식일 수 있습니다. URL 인코딩을 건너뛰려는 경우 "개체" 형식을 사용해야 합니다. 개체 형식을 사용하는 동안 개체에는 "query-parameter-value"를 제공하는 값이라는 속성이 있어야 합니다. 예제:
- "object" 형식의 query-parameter-value:
{ "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
- "string" 형식의 query-parameter-value:
{ "query-parameter-name": "query-parameter-value"}
. 참고: "options.url에 일부 쿼리 매개 변수가 이미 있는 경우 options.queryParameters에 제공된 값이 URL에 추가됩니다.
queryParameters?: {[key: string]: any | ParameterValue}
속성 값
{[key: string]: any | ParameterValue}
serializationMapper
spanOptions
추적: 추적을 사용할 때 범위를 만드는 데 사용되는 옵션입니다.
spanOptions?: SpanOptions
속성 값
tracingContext
추적: 범위를 만들 때 사용되는 컨텍스트입니다.
tracingContext?: Context
속성 값
url
요청 URL입니다. 쿼리 매개 변수가 있을 수도 있고 없을 수도 있습니다. 옵션 개체에 "url"을 제공하거나 "pathTemplate"을 제공합니다. 두 옵션은 모두 함께 사용할 수 없습니다.
url?: string
속성 값
string