BlobServiceClient 클래스

계정 수준에서 Blob 서비스와 상호 작용할 클라이언트입니다.

이 클라이언트는 계정 속성을 검색 및 구성하고 계정 내에서 컨테이너를 나열, 만들기 및 삭제하는 작업을 제공합니다. 특정 컨테이너 또는 Blob과 관련된 작업의 경우 get_client 함수를 사용하여 해당 엔터티에 대한 클라이언트를 검색할 수도 있습니다.

추가 선택적 구성을 보려면 여기를 클릭하세요.

상속

azure.storage.blob._shared.base_client.StorageAccountHostsMixin

BlobServiceClient

azure.storage.blob._encryption.StorageEncryptionMixin

BlobServiceClient

생성자

BlobServiceClient(account_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)

매개 변수

account_url

str

필수

Blob Storage 계정에 대한 URL입니다. URL 경로에 포함된 다른 엔터티(예: 컨테이너 또는 Blob)는 삭제됩니다. 이 URL은 선택적으로 SAS 토큰으로 인증할 수 있습니다.

credential

기본값: None

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials에서 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 리소스 URI에 이미 SAS 토큰이 포함된 경우 명시적 자격 증명을 위해 무시됩니다.

• 충돌하는 SAS 토큰이 ValueError를 발생시키는 AzureSasCredential의 경우를 제외하고. AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.

api_version

str

요청에 사용할 Storage API 버전입니다. 기본값은 현재 SDK와 호환되는 최신 서비스 버전입니다. 이전 버전으로 설정하면 기능 호환성이 저하될 수 있습니다.

버전 12.2.0의 새로운 기능입니다.

secondary_hostname

str

보조 엔드포인트의 호스트 이름입니다.

max_block_size

int

블록 Blob을 청크로 업로드하기 위한 최대 청크 크기입니다. 기본값은 4*1024*1024 또는 4MB입니다.

max_single_put_size

int

Blob 크기가 max_single_put_size 작거나 같으면 하나의 http PUT 요청으로만 Blob이 업로드됩니다. Blob 크기가 max_single_put_size보다 크면 Blob이 청크로 업로드됩니다. 기본값은 64*1024*1024 또는 64MB입니다.

min_large_block_upload_threshold

int

블록 Blob을 업로드할 때 메모리 효율적인 알고리즘을 사용하는 데 필요한 최소 청크 크기입니다. 기본값은 4*1024*1024+1입니다.

use_byte_buffer

bool

블록 Blob 업로드에 바이트 버퍼를 사용합니다. 기본값은 False입니다.

max_page_size

int

페이지 Blob을 업로드하기 위한 최대 청크 크기입니다. 기본값은 4*1024*1024 또는 4MB입니다.

max_single_get_size

int

단일 호출에서 다운로드할 Blob의 최대 크기이며, 초과된 부분은 청크로 다운로드됩니다(병렬일 수 있음). 기본값은 32*1024*1024 또는 32MB입니다.

max_chunk_get_size

int

Blob을 다운로드하는 데 사용되는 최대 청크 크기입니다. 기본값은 4*1024*1024 또는 4MB입니다.

메서드

close	이 메서드는 클라이언트에서 연 소켓을 닫는 것입니다. 컨텍스트 관리자와 함께 를 사용할 때는 사용할 필요가 없습니다.
create_container	지정된 계정 아래에 새 컨테이너를 만듭니다. 동일한 이름의 컨테이너가 이미 있는 경우 ResourceExistsError가 발생합니다. 이 메서드는 새로 만든 컨테이너와 상호 작용할 클라이언트를 반환합니다.
delete_container	삭제할 지정된 컨테이너를 표시합니다. 컨테이너 및 여기에 포함된 모든 blob는 나중에 가비지 수집 중에 삭제됩니다. 컨테이너를 찾을 수 없으면 ResourceNotFoundError가 발생합니다.
find_blobs_by_tags	Blob 필터링 작업을 사용하면 호출자가 태그가 지정된 검색 식과 일치하는 모든 컨테이너에 Blob을 나열할 수 있습니다. Blob 필터링은 스토리지 계정 내의 모든 컨테이너에서 검색하지만 식 내에서 단일 컨테이너로 범위를 지정할 수 있습니다.
from_connection_string	연결 문자열에서 BlobServiceClient를 만듭니다.
get_account_information	스토리지 계정과 관련된 정보를 가져옵니다. 사용자에게 컨테이너 또는 Blob에 대한 SAS가 있는 경우에도 정보를 검색할 수 있습니다. 반환된 사전의 키에는 'sku_name' 및 'account_kind'이 포함됩니다.
get_blob_client	지정된 Blob과 상호 작용할 클라이언트를 가져옵니다. Blob이 아직 필요하지 않습니다.
get_container_client	지정된 컨테이너와 상호 작용할 클라이언트를 가져옵니다. 컨테이너가 아직 필요하지 않습니다.
get_service_properties	Azure 스토리지 분석 포함하여 스토리지 계정의 Blob 서비스의 속성을 가져옵니다.
get_service_stats	Blob 서비스에 대한 복제와 관련된 통계를 검색합니다. 스토리지 계정에 대해 읽기 액세스 지역 중복 복제를 사용하도록 설정한 경우에만 사용할 수 있습니다. 지리적 중복 복제를 사용하여 Azure 저장소는 데이터를 두 위치에서 영구 유지 관리합니다. 두 위치 모두에서 Azure 저장소는 데이터에 대한 여러 정상 복제를 지속적으로 유지 관리합니다. 데이터를 읽거나 만들거나 업데이트하거나 삭제하는 위치는 주 저장소 계정 위치입니다. 기본 위치는 Azure Management Azure 클래식 포털(예: 미국 중북부)을 통해 계정을 만들 때 선택한 지역에 있습니다. 데이터가 복제되는 위치는 보조 위치입니다. 보조 위치는 기본 위치에 따라 자동으로 결정되며, 기본 위치와 동일한 지역에 있는 보조 데이터 센터입니다. 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우, 보조 위치에서 읽기 전용 액세스가 가능합니다.
get_user_delegation_key	SAS 토큰에 서명하기 위한 사용자 위임 키를 가져옵니다. 이 요청이 성공하려면 서비스 개체에 토큰 자격 증명이 있어야 합니다.
list_containers	지정된 계정 아래의 컨테이너를 나열하는 생성기를 반환합니다. 생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 컨테이너가 반환되면 중지됩니다.
set_service_properties	Azure 스토리지 분석 포함하여 스토리지 계정의 Blob 서비스의 속성을 설정합니다. 요소(예: analytics_logging)가 None으로 남아 있으면 해당 기능에 대한 서비스의 기존 설정이 유지됩니다.
undelete_container	일시 삭제된 컨테이너를 복원합니다. 작업은 삭제 보존 정책에 설정된 지정된 일 수 내에 사용되는 경우에만 성공합니다. 버전 12.4.0의 새로운 기능: 이 작업은 API 버전 '2019-12-12'에서 도입되었습니다.

close

이 메서드는 클라이언트에서 연 소켓을 닫는 것입니다. 컨텍스트 관리자와 함께 를 사용할 때는 사용할 필요가 없습니다.

close()

create_container

지정된 계정 아래에 새 컨테이너를 만듭니다.

동일한 이름의 컨테이너가 이미 있는 경우 ResourceExistsError가 발생합니다. 이 메서드는 새로 만든 컨테이너와 상호 작용할 클라이언트를 반환합니다.

create_container(name: str, metadata: Dict[str, str] | None = None, public_access: PublicAccess | str | None = None, **kwargs) -> ContainerClient

매개 변수

name

str

필수

만들 컨테이너의 이름입니다.

metadata

dict(str, str)

필수

컨테이너와 메타데이터로 연결할 이름-값 쌍이 있는 받아쓰기입니다. 예: {'Category':'test'}

public_access

str 또는 PublicAccess

필수

가능한 값은 'container', 'blob'입니다.

container_encryption_scope

dict 또는 ContainerEncryptionScope

컨테이너에서 설정하고 이후의 모든 쓰기에 사용할 기본 암호화 scope 지정합니다.

버전 12.2.0의 새로운 기능입니다.

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환 형식

ContainerClient

delete_container

삭제할 지정된 컨테이너를 표시합니다.

컨테이너 및 여기에 포함된 모든 blob는 나중에 가비지 수집 중에 삭제됩니다. 컨테이너를 찾을 수 없으면 ResourceNotFoundError가 발생합니다.

delete_container(container: ContainerProperties | str, lease: BlobLeaseClient | str | None = None, **kwargs) -> None

매개 변수

container

str 또는 ContainerProperties

필수

삭제할 컨테이너입니다. 컨테이너의 이름 또는 ContainerProperties의 instance 수 있습니다.

lease

필수

지정된 경우 delete_container 컨테이너의 임대가 활성 상태이고 이 ID와 일치하는 경우에만 성공합니다. 컨테이너에 활성 임대가 있는 경우 필요합니다.

if_modified_since

datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 시간 이후 리소스가 수정된 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

if_unmodified_since

datetime

DateTime 값입니다. Azure는 전달된 날짜 값이 UTC일 것으로 예상합니다. 표준 시간대가 포함되면 UTC가 아닌 날짜/시간이 UTC로 변환됩니다. 날짜가 표준 시간대 정보 없이 전달되는 경우 UTC로 간주됩니다. 지정된 날짜/시간 이후 리소스가 수정되지 않은 경우에만 작업을 수행하려면 이 헤더를 지정합니다.

etag

str

ETag 값 또는 와일드카드 문자(*)입니다. 리소스가 변경되었는지 검사 match_condition 매개 변수에 지정된 조건에 따라 작동하는 데 사용됩니다.

match_condition

MatchConditions

etag에 사용할 일치 조건입니다.

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환 형식

None

find_blobs_by_tags

Blob 필터링 작업을 사용하면 호출자가 태그가 지정된 검색 식과 일치하는 모든 컨테이너에 Blob을 나열할 수 있습니다. Blob 필터링은 스토리지 계정 내의 모든 컨테이너에서 검색하지만 식 내에서 단일 컨테이너로 범위를 지정할 수 있습니다.

find_blobs_by_tags(filter_expression: str, **kwargs: Any) -> ItemPaged[FilteredBlob]

매개 변수

filter_expression

str

필수

태그가 지정된 조건과 일치하는 Blob을 찾는 식입니다. 예: ""yourtagname"='firsttag' 및 "yourtagname2"='secondtag'" 컨테이너를 지정하려면 예를 들면 다음과 같습니다. "@container='containerName' 및 "Name"='C'"

results_per_page

int

페이지 매김 시 페이지당 최대 결과입니다.

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

BlobProperties의 반복 가능(자동 페이징) 응답입니다.

반환 형식

ItemPaged[FilteredBlob]

from_connection_string

연결 문자열에서 BlobServiceClient를 만듭니다.

from_connection_string(conn_str: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

매개 변수

conn_str

str

필수

Azure Storage 계정에 대한 연결 문자열입니다.

credential

기본값: None

인증할 자격 증명입니다. 계정 URL에 이미 SAS 토큰이 있거나 연결 문자열에 공유 액세스 키 값이 이미 있는 경우 선택 사항입니다. 값은 SAS 토큰 문자열, azure.core.credentials의 AzureSasCredential 또는 AzureNamedKeyCredential의 instance, 계정 공유 액세스 키 또는 azure.identity에서 TokenCredentials 클래스의 instance 수 있습니다. 여기에 제공된 자격 증명이 연결 문자열의 자격 증명보다 우선합니다. AzureNamedKeyCredential의 instance 사용하는 경우 "name"은 스토리지 계정 이름이고 "키"는 스토리지 계정 키여야 합니다.

반환

Blob 서비스 클라이언트입니다.

반환 형식

BlobServiceClient

get_account_information

스토리지 계정과 관련된 정보를 가져옵니다.

사용자에게 컨테이너 또는 Blob에 대한 SAS가 있는 경우에도 정보를 검색할 수 있습니다. 반환된 사전의 키에는 'sku_name' 및 'account_kind'이 포함됩니다.

get_account_information(**kwargs: Any) -> Dict[str, str]

반환

계정 정보(SKU 및 계정 유형)의 받아쓰기입니다.

반환 형식

dict(str, str)

get_blob_client

지정된 Blob과 상호 작용할 클라이언트를 가져옵니다.

Blob이 아직 필요하지 않습니다.

get_blob_client(container: ContainerProperties | str, blob: BlobProperties | str, snapshot: Dict[str, Any] | str | None = None, *, version_id: str | None = None) -> BlobClient

매개 변수

container

str 또는 ContainerProperties

필수

Blob이 있는 컨테이너입니다. 컨테이너의 이름 또는 ContainerProperties의 instance 수 있습니다.

blob

str 또는 BlobProperties

필수

상호 작용할 Blob입니다. Blob의 이름 또는 BlobProperties의 instance 수 있습니다.

snapshot

str 또는 dict(str, Any)

기본값: None

작동할 선택적 Blob 스냅샷. 이는 스냅샷 ID이거나 에서 반환create_snapshot된 사전 출력일 수 있습니다.

version_id

str

버전 ID 매개 변수는 불투명 DateTime 값으로, 있을 때 작동할 Blob의 버전을 지정합니다.

반환

BlobClient입니다.

반환 형식

BlobClient

get_container_client

지정된 컨테이너와 상호 작용할 클라이언트를 가져옵니다.

컨테이너가 아직 필요하지 않습니다.

get_container_client(container: ContainerProperties | str) -> ContainerClient

매개 변수

container

str 또는 ContainerProperties

필수

컨테이너입니다. 컨테이너의 이름 또는 ContainerProperties의 instance 수 있습니다.

반환

ContainerClient입니다.

반환 형식

ContainerClient

get_service_properties

Azure 스토리지 분석 포함하여 스토리지 계정의 Blob 서비스의 속성을 가져옵니다.

get_service_properties(**kwargs: Any) -> Dict[str, Any]

매개 변수

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

분석 로깅, 시간/분 메트릭, cors 규칙 등과 같은 Blob 서비스 속성을 포함하는 개체입니다.

반환 형식

Dict[str, Any]

get_service_stats

Blob 서비스에 대한 복제와 관련된 통계를 검색합니다.

스토리지 계정에 대해 읽기 액세스 지역 중복 복제를 사용하도록 설정한 경우에만 사용할 수 있습니다.

지리적 중복 복제를 사용하여 Azure 저장소는 데이터를 두 위치에서 영구 유지 관리합니다. 두 위치 모두에서 Azure 저장소는 데이터에 대한 여러 정상 복제를 지속적으로 유지 관리합니다. 데이터를 읽거나 만들거나 업데이트하거나 삭제하는 위치는 주 저장소 계정 위치입니다. 기본 위치는 Azure Management Azure 클래식 포털(예: 미국 중북부)을 통해 계정을 만들 때 선택한 지역에 있습니다. 데이터가 복제되는 위치는 보조 위치입니다. 보조 위치는 기본 위치에 따라 자동으로 결정되며, 기본 위치와 동일한 지역에 있는 보조 데이터 센터입니다. 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우, 보조 위치에서 읽기 전용 액세스가 가능합니다.

get_service_stats(**kwargs: Any) -> Dict[str, Any]

매개 변수

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

Blob 서비스 통계입니다.

반환 형식

Dict[str, Any]

get_user_delegation_key

SAS 토큰에 서명하기 위한 사용자 위임 키를 가져옵니다. 이 요청이 성공하려면 서비스 개체에 토큰 자격 증명이 있어야 합니다.

get_user_delegation_key(key_start_time: datetime, key_expiry_time: datetime, **kwargs: Any) -> UserDelegationKey

매개 변수

key_start_time

datetime

필수

DateTime 값입니다. 키가 유효한 시기를 나타냅니다.

key_expiry_time

datetime

필수

DateTime 값입니다. 키가 유효하지 않을 때를 나타냅니다.

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

사용자 위임 키입니다.

반환 형식

UserDelegationKey

list_containers

지정된 계정 아래의 컨테이너를 나열하는 생성기를 반환합니다.

생성기는 서비스에서 반환된 연속 토큰을 느리게 따르고 모든 컨테이너가 반환되면 중지됩니다.

list_containers(name_starts_with: str | None = None, include_metadata: bool | None = False, **kwargs) -> ItemPaged[ContainerProperties]

매개 변수

name_starts_with

str

필수

결과를 필터링하여 이름이 지정된 접두사로 시작하는 컨테이너만 반환합니다.

include_metadata

bool

필수

응답에서 반환할 컨테이너 메타데이터를 지정합니다. 기본값은 False입니다.

include_deleted

bool

응답에서 삭제된 컨테이너를 반환하도록 지정합니다. 컨테이너 복원이 설정된 계정용입니다. 기본값은 False입니다. .. versionadded:: 12.4.0

include_system

bool

시스템 컨테이너를 포함할 것을 지정하는 플래그입니다. .. versionadded:: 12.10.0

results_per_page

int

API 호출당 검색할 최대 컨테이너 이름 수입니다. 요청이 지정하지 않으면 서버는 최대 5,000개 항목을 반환합니다.

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

ContainerProperties의 반복 가능(자동 페이징)입니다.

반환 형식

ItemPaged[ContainerProperties]

set_service_properties

Azure 스토리지 분석 포함하여 스토리지 계정의 Blob 서비스의 속성을 설정합니다.

요소(예: analytics_logging)가 None으로 남아 있으면 해당 기능에 대한 서비스의 기존 설정이 유지됩니다.

set_service_properties(analytics_logging: BlobAnalyticsLogging | None = None, hour_metrics: Metrics | None = None, minute_metrics: Metrics | None = None, cors: List[CorsRule] | None = None, target_version: str | None = None, delete_retention_policy: RetentionPolicy | None = None, static_website: StaticWebsite | None = None, **kwargs) -> None

매개 변수

analytics_logging

BlobAnalyticsLogging

필수

Azure 분석 Logging 설정을 그룹화합니다.

hour_metrics

Metrics

필수

시간 메트릭 설정은 API별로 그룹화된 요청 통계의 요약을 Blob에 대한 시간별 집계로 제공합니다.

minute_metrics

Metrics

필수

분 메트릭 설정은 Blob의 각 분에 대한 요청 통계를 제공합니다.

cors

list[CorsRule]

필수

목록에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 빈 목록을 지정하면 모든 CORS 규칙이 삭제되고 서비스에 대해 CORS가 비활성화됩니다.

target_version

str

필수

들어오는 요청의 버전이 지정되지 않은 경우 요청에 사용할 기본 버전을 나타냅니다.

delete_retention_policy

RetentionPolicy

필수

삭제 보존 정책은 삭제된 Blob을 유지할지 여부를 지정합니다. 또한 유지할 Blob의 일 수와 버전을 지정합니다.

static_website

StaticWebsite

필수

정적 웹 사이트 기능을 사용할지 여부를 지정하고, 그렇다면 사용할 인덱스 문서와 404 오류 문서를 나타냅니다.

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환 형식

None

undelete_container

일시 삭제된 컨테이너를 복원합니다.

작업은 삭제 보존 정책에 설정된 지정된 일 수 내에 사용되는 경우에만 성공합니다.

버전 12.4.0의 새로운 기능: 이 작업은 API 버전 '2019-12-12'에서 도입되었습니다.

undelete_container(deleted_container_name: str, deleted_container_version: str, **kwargs: Any) -> ContainerClient

매개 변수

deleted_container_name

str

필수

복원할 삭제된 컨테이너의 이름을 지정합니다.

deleted_container_version

str

필수

복원할 삭제된 컨테이너의 버전을 지정합니다.

timeout

int

작업에 대한 서버 쪽 시간 제한을 초 단위로 설정합니다. 자세한 내용은 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 를 참조하세요. 이 값은 클라이언트에서 추적되거나 유효성이 검사되지 않습니다. 클라이언트 쪽 네트워크 시간 제한을 구성하려면 여기를 참조 하세요.

반환

삭제되지 않은 ContainerClient입니다.

반환 형식

ContainerClient

특성

api_version

요청에 사용되는 Storage API의 버전입니다.

location_mode

클라이언트가 현재 사용 중인 위치 모드입니다.

기본적으로 "기본"입니다. 옵션에는 "기본" 및 "보조"가 포함됩니다.

primary_endpoint

전체 기본 엔드포인트 URL입니다.

primary_hostname

기본 엔드포인트의 호스트 이름입니다.

secondary_endpoint

구성된 경우 전체 보조 엔드포인트 URL입니다.

사용할 수 없는 경우 ValueError가 발생합니다. 보조 호스트 이름을 명시적으로 지정하려면 인스턴스화에 선택적 secondary_hostname 키워드(keyword) 인수를 사용합니다.

예외

ValueError

secondary_hostname

보조 엔드포인트의 호스트 이름입니다.

사용할 수 없는 경우 없음이 됩니다. 보조 호스트 이름을 명시적으로 지정하려면 인스턴스화에 선택적 secondary_hostname 키워드(keyword) 인수를 사용합니다.

url

사용되는 경우 SAS 토큰을 포함하여 이 엔터티에 대한 전체 엔드포인트 URL입니다.

이는 기본 엔드포인트이거나 현재 location_mode에 따라 보조 엔드포인트일 수 있습니다. :returns: 사용되는 경우 SAS 토큰을 포함하여 이 엔터티에 대한 전체 엔드포인트 URL입니다. :rtype: str