SASQueryParameters class
Azure Storage SAS의 쿼리 매개 변수를 구성하는 구성 요소를 나타냅니다. 이 형식은 사용자가 직접 생성하지 않습니다. AccountSASSignatureValues 및 <xref:BlobSASSignatureValues> 형식에서만 생성됩니다. 생성되면 로 인코딩하고 URL에 toString() 직접 추가할 수 있습니다(기존 쿼리 매개 변수가 있는 경우 이러한 쿼리 매개 변수를 추가하는 적절한 수단에 영향을 줄 수 있는 경우 여기서 주의해야 합니다).
참고: 이 클래스의 인스턴스는 변경할 수 없습니다.
생성자
속성
agent |
GUID 형식의 권한 없는 AAD 개체 ID입니다. 사용자 위임 키의 소유자가 권한이 없는 것으로 간주되는 사용자의 AAD 개체 ID입니다. Azure Storage 서비스는 추가 POSIX ACL 검사를 수행하여 사용자에게 요청된 작업을 수행할 권한이 있는지 확인합니다. 를 사용하여 구성하는 <xref:signedAuthorizedUserObjectId>데 사용할 수 없습니다. 사용자 위임 SAS에만 사용됩니다. |
cache |
Blob/File Service SAS의 캐시 제어 헤더에 대한 값입니다. |
content |
Blob/File Service SAS의 콘텐츠 처리 헤더에 대한 값입니다. |
content |
Blob/File Service SAS의 콘텐츠 인코딩 헤더에 대한 값입니다. |
content |
Blob/File Service SAS의 콘텐츠 길이 헤더에 대한 값입니다. |
content |
Blob/File Service SAS의 콘텐츠 형식 헤더에 대한 값입니다. |
correlation |
스토리지 진단 로그에 기록되고 SAS 생성과 스토리지 리소스 액세스의 상관 관계를 지정하는 데 사용할 수 있는 GUID 값입니다. 사용자 위임 SAS에만 사용됩니다. |
directory |
문자열-서명의 canonicalizedresource 필드에 지정된 디렉터리의 깊이를 나타냅니다. 디렉터리의 깊이는 루트 폴더 아래의 디렉터리 수입니다. |
encryption |
선택 사항입니다. 이 SAS URI로 권한이 부여된 요청을 보낼 때 사용할 암호화 범위입니다. |
expires |
식별자가 제공되는 경우에만 선택 사항입니다. 이 SAS 토큰의 만료 시간입니다. |
identifier | 선택 사항입니다. 서명된 식별자입니다(에만 <xref:BlobSASSignatureValues>해당). https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy을 참조하십시오. |
ip |
선택 사항입니다. 이 SAS에 허용되는 IP 범위입니다. |
permissions | 식별자가 제공되는 경우에만 선택 사항입니다. 자세한 내용은 AccountSASPermissions, <xref:BlobSASPermissions>또는 <xref:ContainerSASPermissions> 을 참조하세요. |
preauthorized |
GUID 형식의 권한 있는 AAD 개체 ID입니다. SAS에서 부여한 작업을 수행하기 위해 사용자 위임 키의 소유자가 권한을 부여한 사용자의 AAD 개체 ID입니다. Azure Storage 서비스는 액세스 권한을 부여하기 전에 사용자 위임 키의 소유자가 필요한 권한을 갖도록 하지만 이 값에 지정된 사용자에 대한 추가 권한 검사는 수행되지 않습니다. 를 사용하여 구성하는 <xref:signedUnauthorizedUserObjectId>데 사용할 수 없습니다. 사용자 위임 SAS에만 사용됩니다. |
protocol | 선택 사항입니다. 허용되는 HTTP 프로토콜입니다. |
resource | 선택 사항입니다. SAS를 통해 액세스할 수 있는 리소스를 지정합니다(에만 <xref:BlobSASSignatureValues>해당). |
resource |
선택 사항입니다. 액세스되는 스토리지 리소스 유형(계정 SAS에만 해당). 자세한 내용은 AccountSASResourceTypes 를 참조하세요. |
services | 선택 사항입니다. 액세스되는 스토리지 서비스(계정 SAS에만 해당). 자세한 내용은 AccountSASServices 를 참조하세요. |
signature | SAS 토큰에 대한 서명입니다. |
starts |
선택 사항입니다. 이 SAS 토큰의 시작 시간입니다. |
version | 스토리지 API 버전입니다. |
메서드
to |
모든 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
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
resource
선택 사항입니다. SAS를 통해 액세스할 수 있는 리소스를 지정합니다(에만 <xref:BlobSASSignatureValues>해당).
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