다음을 통해 공유


SASQueryParameters class

Azure Storage SAS의 쿼리 매개 변수를 구성하는 구성 요소를 나타냅니다. 이 형식은 사용자가 직접 생성하지 않습니다. AccountSASSignatureValues 및 <xref:BlobSASSignatureValues> 형식에서만 생성됩니다. 생성되면 로 인코딩하고 URL에 toString() 직접 추가할 수 있습니다(기존 쿼리 매개 변수가 있는 경우 이러한 쿼리 매개 변수를 추가하는 적절한 수단에 영향을 줄 수 있는 경우 여기서 주의해야 합니다).

참고: 이 클래스의 인스턴스는 변경할 수 없습니다.

생성자

SASQueryParameters(string, string, SASQueryParametersOptions)

SASQueryParameters의 인스턴스를 만듭니다.

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, number, string, string, string, string)

SASQueryParameters의 인스턴스를 만듭니다.

속성

agentObjectId

GUID 형식의 권한 없는 AAD 개체 ID입니다. 사용자 위임 키의 소유자가 권한이 없는 것으로 간주되는 사용자의 AAD 개체 ID입니다. Azure Storage 서비스는 추가 POSIX ACL 검사를 수행하여 사용자에게 요청된 작업을 수행할 권한이 있는지 확인합니다. 를 사용하여 구성하는 <xref:signedAuthorizedUserObjectId>데 사용할 수 없습니다. 사용자 위임 SAS에만 사용됩니다.

cacheControl

Blob/File Service SAS의 캐시 제어 헤더에 대한 값입니다.

contentDisposition

Blob/File Service SAS의 콘텐츠 처리 헤더에 대한 값입니다.

contentEncoding

Blob/File Service SAS의 콘텐츠 인코딩 헤더에 대한 값입니다.

contentLanguage

Blob/File Service SAS의 콘텐츠 길이 헤더에 대한 값입니다.

contentType

Blob/File Service SAS의 콘텐츠 형식 헤더에 대한 값입니다.

correlationId

스토리지 진단 로그에 기록되고 SAS 생성과 스토리지 리소스 액세스의 상관 관계를 지정하는 데 사용할 수 있는 GUID 값입니다. 사용자 위임 SAS에만 사용됩니다.

directoryDepth

문자열-서명의 canonicalizedresource 필드에 지정된 디렉터리의 깊이를 나타냅니다. 디렉터리의 깊이는 루트 폴더 아래의 디렉터리 수입니다.

encryptionScope

선택 사항입니다. 이 SAS URI로 권한이 부여된 요청을 보낼 때 사용할 암호화 범위입니다.

expiresOn

식별자가 제공되는 경우에만 선택 사항입니다. 이 SAS 토큰의 만료 시간입니다.

identifier

선택 사항입니다. 서명된 식별자입니다(에만 <xref:BlobSASSignatureValues>해당).

https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy을 참조하십시오.

ipRange

선택 사항입니다. 이 SAS에 허용되는 IP 범위입니다.

permissions

식별자가 제공되는 경우에만 선택 사항입니다. 자세한 내용은 AccountSASPermissions, <xref:BlobSASPermissions>또는 <xref:ContainerSASPermissions> 을 참조하세요.

preauthorizedAgentObjectId

GUID 형식의 권한 있는 AAD 개체 ID입니다. SAS에서 부여한 작업을 수행하기 위해 사용자 위임 키의 소유자가 권한을 부여한 사용자의 AAD 개체 ID입니다. Azure Storage 서비스는 액세스 권한을 부여하기 전에 사용자 위임 키의 소유자가 필요한 권한을 갖도록 하지만 이 값에 지정된 사용자에 대한 추가 권한 검사는 수행되지 않습니다. 를 사용하여 구성하는 <xref:signedUnauthorizedUserObjectId>데 사용할 수 없습니다. 사용자 위임 SAS에만 사용됩니다.

protocol

선택 사항입니다. 허용되는 HTTP 프로토콜입니다.

resource

선택 사항입니다. SAS를 통해 액세스할 수 있는 리소스를 지정합니다(에만 <xref:BlobSASSignatureValues>해당).

https://docs.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only을 참조하십시오.

resourceTypes

선택 사항입니다. 액세스되는 스토리지 리소스 유형(계정 SAS에만 해당). 자세한 내용은 AccountSASResourceTypes 를 참조하세요.

services

선택 사항입니다. 액세스되는 스토리지 서비스(계정 SAS에만 해당). 자세한 내용은 AccountSASServices 를 참조하세요.

signature

SAS 토큰에 대한 서명입니다.

startsOn

선택 사항입니다. 이 SAS 토큰의 시작 시간입니다.

version

스토리지 API 버전입니다.

메서드

toString()

모든 SAS 쿼리 매개 변수를 URL에 추가할 수 있는 문자열로 인코딩합니다.

생성자 세부 정보

SASQueryParameters(string, string, SASQueryParametersOptions)

SASQueryParameters의 인스턴스를 만듭니다.

new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)

매개 변수

version

string

스토리지 버전 표시

signature

string

SAS 토큰의 서명을 나타냅니다.

options
SASQueryParametersOptions

선택 사항입니다. SASQueryParameters를 생성하는 옵션입니다.

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, number, string, string, string, string)

SASQueryParameters의 인스턴스를 만듭니다.

new SASQueryParameters(version: string, signature: string, permissions?: string, services?: string, resourceTypes?: string, protocol?: SASProtocol, startsOn?: Date, expiresOn?: Date, ipRange?: SasIPRange, identifier?: string, resource?: string, cacheControl?: string, contentDisposition?: string, contentEncoding?: string, contentLanguage?: string, contentType?: string, userDelegationKey?: UserDelegationKey, directoryDepth?: number, preauthorizedAgentObjectId?: string, agentObjectId?: string, correlationId?: string, encryptionScope?: string)

매개 변수

version

string

스토리지 버전 표시

signature

string

SAS 토큰의 서명을 나타냅니다.

permissions

string

스토리지 사용 권한 표시

services

string

액세스되는 스토리지 서비스 표시(계정 SAS에만 해당)

resourceTypes

string

액세스되는 스토리지 리소스 유형 표시(계정 SAS에만 해당)

protocol
SASProtocol

허용되는 HTTP 프로토콜을 나타냅니다.

startsOn

Date

이 SAS 토큰의 시작 시간 표시

expiresOn

Date

이 SAS 토큰의 만료 시간 표시

ipRange
SasIPRange

이 SAS 토큰의 유효한 IP 주소 범위를 나타냅니다.

identifier

string

서명된 식별자 표시(서비스 SAS에만 해당)

resource

string

스토리지 컨테이너 또는 Blob 표현(서비스 SAS에만 해당)

cacheControl

string

캐시 제어 헤더 표시(Blob/File Service SAS에만 해당)

contentDisposition

string

콘텐츠 처리 헤더 표시(Blob/File Service SAS에만 해당)

contentEncoding

string

콘텐츠 인코딩 헤더 표시(Blob/File Service SAS에만 해당)

contentLanguage

string

콘텐츠 언어 헤더 표시(Blob/File Service SAS에만 해당)

contentType

string

콘텐츠 형식 헤더 표시(Blob/File Service SAS에만 해당)

userDelegationKey
UserDelegationKey

사용자 위임 키 속성 표시

directoryDepth

number

preauthorizedAgentObjectId

string

권한 있는 AAD 개체 ID 표시(사용자 위임 SAS에만 해당)

agentObjectId

string

권한이 없는 AAD 개체 ID 표시(사용자 위임 SAS에만 해당)

correlationId

string

상관 관계 ID 표시(사용자 위임 SAS에만 해당)

encryptionScope

string

속성 세부 정보

agentObjectId

GUID 형식의 권한 없는 AAD 개체 ID입니다. 사용자 위임 키의 소유자가 권한이 없는 것으로 간주되는 사용자의 AAD 개체 ID입니다. Azure Storage 서비스는 추가 POSIX ACL 검사를 수행하여 사용자에게 요청된 작업을 수행할 권한이 있는지 확인합니다. 를 사용하여 구성하는 <xref:signedAuthorizedUserObjectId>데 사용할 수 없습니다. 사용자 위임 SAS에만 사용됩니다.

agentObjectId?: string

속성 값

string

cacheControl

Blob/File Service SAS의 캐시 제어 헤더에 대한 값입니다.

cacheControl?: string

속성 값

string

contentDisposition

Blob/File Service SAS의 콘텐츠 처리 헤더에 대한 값입니다.

contentDisposition?: string

속성 값

string

contentEncoding

Blob/File Service SAS의 콘텐츠 인코딩 헤더에 대한 값입니다.

contentEncoding?: string

속성 값

string

contentLanguage

Blob/File Service SAS의 콘텐츠 길이 헤더에 대한 값입니다.

contentLanguage?: string

속성 값

string

contentType

Blob/File Service SAS의 콘텐츠 형식 헤더에 대한 값입니다.

contentType?: string

속성 값

string

correlationId

스토리지 진단 로그에 기록되고 SAS 생성과 스토리지 리소스 액세스의 상관 관계를 지정하는 데 사용할 수 있는 GUID 값입니다. 사용자 위임 SAS에만 사용됩니다.

correlationId?: string

속성 값

string

directoryDepth

문자열-서명의 canonicalizedresource 필드에 지정된 디렉터리의 깊이를 나타냅니다. 디렉터리의 깊이는 루트 폴더 아래의 디렉터리 수입니다.

directoryDepth?: number

속성 값

number

encryptionScope

선택 사항입니다. 이 SAS URI로 권한이 부여된 요청을 보낼 때 사용할 암호화 범위입니다.

encryptionScope?: string

속성 값

string

expiresOn

식별자가 제공되는 경우에만 선택 사항입니다. 이 SAS 토큰의 만료 시간입니다.

expiresOn?: Date

속성 값

Date

identifier

선택 사항입니다. 서명된 식별자입니다(에만 <xref:BlobSASSignatureValues>해당).

https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy을 참조하십시오.

identifier?: string

속성 값

string

ipRange

선택 사항입니다. 이 SAS에 허용되는 IP 범위입니다.

undefined | SasIPRange ipRange

속성 값

undefined | SasIPRange

permissions

식별자가 제공되는 경우에만 선택 사항입니다. 자세한 내용은 AccountSASPermissions, <xref:BlobSASPermissions>또는 <xref:ContainerSASPermissions> 을 참조하세요.

permissions?: string

속성 값

string

preauthorizedAgentObjectId

GUID 형식의 권한 있는 AAD 개체 ID입니다. SAS에서 부여한 작업을 수행하기 위해 사용자 위임 키의 소유자가 권한을 부여한 사용자의 AAD 개체 ID입니다. Azure Storage 서비스는 액세스 권한을 부여하기 전에 사용자 위임 키의 소유자가 필요한 권한을 갖도록 하지만 이 값에 지정된 사용자에 대한 추가 권한 검사는 수행되지 않습니다. 를 사용하여 구성하는 <xref:signedUnauthorizedUserObjectId>데 사용할 수 없습니다. 사용자 위임 SAS에만 사용됩니다.

preauthorizedAgentObjectId?: string

속성 값

string

protocol

선택 사항입니다. 허용되는 HTTP 프로토콜입니다.

protocol?: SASProtocol

속성 값

resource

선택 사항입니다. SAS를 통해 액세스할 수 있는 리소스를 지정합니다(에만 <xref:BlobSASSignatureValues>해당).

https://docs.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only을 참조하십시오.

resource?: string

속성 값

string

resourceTypes

선택 사항입니다. 액세스되는 스토리지 리소스 유형(계정 SAS에만 해당). 자세한 내용은 AccountSASResourceTypes 를 참조하세요.

resourceTypes?: string

속성 값

string

services

선택 사항입니다. 액세스되는 스토리지 서비스(계정 SAS에만 해당). 자세한 내용은 AccountSASServices 를 참조하세요.

services?: string

속성 값

string

signature

SAS 토큰에 대한 서명입니다.

signature: string

속성 값

string

startsOn

선택 사항입니다. 이 SAS 토큰의 시작 시간입니다.

startsOn?: Date

속성 값

Date

version

스토리지 API 버전입니다.

version: string

속성 값

string

메서드 세부 정보

toString()

모든 SAS 쿼리 매개 변수를 URL에 추가할 수 있는 문자열로 인코딩합니다.

function toString(): string

반환

string