使用 Python 为容器或 blob 创建服务 SAS

可以使用以下方法创建服务 SAS，以委派对容器资源的有限访问权限：

• generate_container_sas

用于对 SAS 进行签名的存储帐户访问密钥将会作为 account_key 参数传递到方法。 允许的权限将作为 permission 参数传递给方法，并在 ContainerSasPermissions 类中进行定义。

以下代码示例显示了如何为容器资源创建具有读取权限的服务 SAS：

def create_service_sas_container(self, container_client: ContainerClient, account_key: str):
    # Create a SAS token that's valid for one day, as an example
    start_time = datetime.datetime.now(datetime.timezone.utc)
    expiry_time = start_time + datetime.timedelta(days=1)

    sas_token = generate_container_sas(
        account_name=container_client.account_name,
        container_name=container_client.container_name,
        account_key=account_key,
        permission=ContainerSasPermissions(read=True),
        expiry=expiry_time,
        start=start_time
    )

    return sas_token

可以使用以下方法创建服务 SAS，以委派对 Blob 资源的有限访问权限：

• generate_blob_sas

用于对 SAS 进行签名的存储帐户访问密钥将会作为 account_key 参数传递到该方法。 允许的权限将作为 permission 参数传递给该方法，并在 BlobSasPermissions 类中进行定义。

以下代码示例显示了如何为 blob 资源创建具有读取权限的服务 SAS：

def create_service_sas_blob(self, blob_client: BlobClient, account_key: str):
    # Create a SAS token that's valid for one day, as an example
    start_time = datetime.datetime.now(datetime.timezone.utc)
    expiry_time = start_time + datetime.timedelta(days=1)

    sas_token = generate_blob_sas(
        account_name=blob_client.account_name,
        container_name=blob_client.container_name,
        blob_name=blob_client.blob_name,
        account_key=account_key,
        permission=BlobSasPermissions(read=True),
        expiry=expiry_time,
        start=start_time
    )

    return sas_token

以下代码示例显示了如何使用在先前示例中创建的服务 SAS 来授权 ContainerClient 对象。 此客户端对象可用于根据 SAS 授予的权限对容器资源执行操作。

# The SAS token string can be appended to the resource URL with a ? delimiter
# or passed as the credential argument to the client constructor
sas_url = f"{container_client.url}?{sas_token}"

# Create a ContainerClient object with SAS authorization
container_client_sas = ContainerClient.from_container_url(container_url=sas_url)

以下代码示例显示了如何使用在较早的示例中创建的服务 SAS 来授权 BlobClient 对象。 此客户端对象可用于根据 SAS 授予的权限对 blob 资源执行操作。

# The SAS token string can be appended to the resource URL with a ? delimiter
# or passed as the credential argument to the client constructor
sas_url = f"{blob_client.url}?{sas_token}"

# Create a BlobClient object with SAS authorization
blob_client_sas = BlobClient.from_blob_url(blob_url=sas_url)