Compartir a través de


BlobSasBuilder Clase

Definición

BlobSasBuilder se usa para generar una firma de acceso compartido (SAS) para un contenedor o blob de Azure Storage. Para obtener más información, vea Cree una SAS de servicio.

public class BlobSasBuilder
type BlobSasBuilder = class
Public Class BlobSasBuilder
Herencia
BlobSasBuilder

Constructores

BlobSasBuilder(BlobContainerSasPermissions, DateTimeOffset)

Inicializa una nueva instancia de la BlobSasBuilder clase para crear una sas de Blob Container Service.

BlobSasBuilder(BlobSasPermissions, DateTimeOffset)

Inicializa una nueva instancia de la BlobSasBuilder clase para crear una sas de Blob Service.

Propiedades

BlobContainerName

Nombre del contenedor de blobs al que se hace accesible.

BlobName

Nombre del blob al que se hace accesible o Empty para una SAS de contenedor.

BlobVersionId

Nombre de la versión de blob a la que se hace accesible o Empty para una SAS de blob.

CacheControl

Invalide el valor devuelto para Cache-Control encabezado de respuesta.

ContentDisposition

Invalide el valor devuelto para el encabezado de respuesta Content-Disposition.

ContentEncoding

Invalide el valor devuelto para el encabezado de respuesta Content-Encoding.

ContentLanguage

Invalide el valor devuelto para el encabezado de respuesta Content-Language.

ContentType

Invalide el valor devuelto para el encabezado de respuesta Content-Type.

CorrelationId

Opcional. A partir de la versión 2020-02-10, este valor se usará para correlacionar los registros de auditoría de almacenamiento con los registros de auditoría usados por la entidad de seguridad que genera y distribuye SAS. Esto solo se usa para la SAS de delegación de usuarios.

EncryptionScope

Opcional. Ámbito de cifrado que se va a usar al enviar solicitudes autorizadas con este URI de SAS.

ExpiresOn

Hora en la que la firma de acceso compartido deja de ser válida. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada.

Identifier

Valor único opcional de hasta 64 caracteres de longitud que se correlaciona con una directiva de acceso especificada para el contenedor.

IPRange

Especifica una dirección IP o un intervalo de direcciones IP de las que se van a aceptar solicitudes. Si la dirección IP desde la que se origina la solicitud no coincide con la dirección IP o el intervalo de direcciones especificado en el token de SAS, la solicitud no se autentica. Al especificar un intervalo de direcciones IP, tenga en cuenta que el intervalo es inclusivo.

Permissions

Permisos asociados a la firma de acceso compartido. El usuario está restringido a las operaciones permitidas por los permisos. Este campo se debe omitir si se ha especificado en una directiva de acceso almacenada asociada. Los BlobSasPermissionsobjetos , BlobContainerSasPermissions, SnapshotSasPermissionso BlobAccountSasPermissions se pueden usar para crear la cadena de permisos.

PreauthorizedAgentObjectId

Opcional. A partir de la versión 2020-02-10, este valor se usará para el identificador de objeto de AAD de un usuario autorizado por el propietario de la clave de delegación de usuarios para realizar la acción concedida por la SAS. El servicio Azure Storage garantizará que el propietario de la clave de delegación de usuarios tenga los permisos necesarios antes de conceder acceso. No se realizará ninguna comprobación de permisos adicional para el usuario especificado en este valor. Esto solo se usa con la generación de SAS de delegación de usuarios.

Protocol

El campo de protocolo firmado opcional especifica el protocolo permitido para una solicitud realizada con la SAS. Los valores posibles son HttpsAndHttp, Https y None.

Resource

Especifica qué recursos son accesibles a través de la firma de acceso compartido.

Especifique "b" si el recurso compartido es un blob. Esto concede acceso al contenido y los metadatos del blob.

Especifique "c" si el recurso compartido es un contenedor de blobs. Esto concede acceso al contenido y los metadatos de cualquier blob del contenedor, y a la lista de blobs del contenedor.

A partir de la versión 2018-11-09, especifique "bs" si el recurso compartido es una instantánea de blob. Esto concede acceso al contenido y los metadatos de la instantánea específica, pero no al blob raíz correspondiente.

A partir de la versión 2019-12-12, especifique "bv" si el recurso compartido es una versión de blob. Esto concede acceso al contenido y los metadatos de la versión específica, pero no al blob raíz correspondiente.

Snapshot

Nombre de la instantánea a la que se hace accesible o Empty para una SAS de blob.

StartsOn

Opcionalmente, especifique la hora en la que la firma de acceso compartido se convierte en válida. Si se omite cuando se usa DateTimeOffset.MinValue, se supone que la hora de inicio de esta llamada es la hora en que el servicio de almacenamiento recibe la solicitud.

Métodos

SetPermissions(BlobAccountSasPermissions)

Establece los permisos para una SAS de nivel de cuenta de blob.

SetPermissions(BlobContainerSasPermissions)

Establece los permisos para una SAS de contenedor de blobs.

SetPermissions(BlobSasPermissions)

Establece los permisos de una SAS de blob.

SetPermissions(BlobVersionSasPermissions)

Establece los permisos de una SAS de versión.

SetPermissions(SnapshotSasPermissions)

Establece los permisos de una SAS de instantánea.

SetPermissions(String)

Establece los permisos para la SAS mediante una cadena de permisos sin procesar.

SetPermissions(String, Boolean)

Establece los permisos para la SAS mediante una cadena de permisos sin procesar.

ToSasQueryParameters(StorageSharedKeyCredential)

Use una cuenta StorageSharedKeyCredential para firmar estos valores de firma de acceso compartido para generar los parámetros de consulta SAS adecuados para autenticar solicitudes.

ToSasQueryParameters(UserDelegationKey, String)

Use una cuenta UserDelegationKey para firmar estos valores de firma de acceso compartido para generar los parámetros de consulta SAS adecuados para autenticar solicitudes.

Se aplica a