BlobSasBuilder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Azure SDK for .NET