Todos los productos
Search
Centro de documentos

Object Storage Service:OSS authorization syntax and elements

Última actualización: Sep 03, 2026

OSS utiliza directivas de autorización en formato JSON para implementar un control de acceso detallado. Este tema sirve como referencia rápida sobre la sintaxis y los elementos de dichas directivas.

Sintaxis de autorización

Las directivas de autorización de OSS emplean JSON con dos campos principales: Version y Statement.

Estructura de la sintaxis

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow|Deny",
            "Action": ["oss:ActionName"],
            "Principal": ["UID|*"],
            "Resource": ["acs:oss:*:*:bucket-name/*"],
            "Condition": {
                "ConditionOperator": {
                    "ConditionKey": ["Value"]
                }
            }
        }
    ]
}

Descripción de los campos

Campo

Descripción

Obligatorio

Version

Versión de la directiva. Valor fijo: 1.

Sí

Statement

Cuerpo de la directiva. Contiene una o varias reglas de permiso o denegación.

Sí

Elementos de Statement

Elemento

Descripción

Obligatorio

Effect

Efecto de la directiva. Valores válidos: Allow y Deny.

Sí

Action

Operación que se aplica a un recurso. Admite el comodín *.

Sí

Principal

Entidad a la que afecta la directiva, como un usuario, una cuenta o un rol. Una lista vacía [ ] equivale a ["*"]. Nota: Las directivas de RAM no incluyen este campo.

Obligatorio en directivas de bucket

Resource

Recursos a los que afecta la directiva. Admite el comodín *.

Sí

Condition

Condiciones bajo las cuales surte efecto la directiva. Cuando existen varias condiciones, se evalúan con una relación AND: deben cumplirse todas.

No

Action

Las acciones se clasifican en operaciones a nivel de servicio, de bucket y de objeto.

Nivel de servicio

API

Action

Descripción de la API

ListBuckets (GetService)

oss:ListBuckets

Lista todos los buckets propiedad del solicitante.

ListUserDataRedundancyTransition

oss:ListUserDataRedundancyTransition

Lista todas las tareas de transición de redundancia de almacenamiento del solicitante.

Ninguna

oss:ActivateProduct

Activa OSS y el servicio Content Moderation.

Ninguna

oss:CreateOrder

Crea pedidos para planes de recursos de OSS.

PutPublicAccessBlock

oss:PutPublicAccessBlock

Habilita Block Public Access para todo OSS.

GetPublicAccessBlock

oss:GetPublicAccessBlock

Obtiene la configuración global de Block Public Access.

DeletePublicAccessBlock

oss:DeletePublicAccessBlock

Elimina la configuración global de Block Public Access.

Nivel de bucket

API

Action

Descripción de la API

PutBucket

oss:PutBucket

Crea un bucket.

GetBucket (ListObjects)

oss:ListObjects

Enumera la información de todos los objetos en un bucket.

GetBucketInfo

oss:GetBucketInfo

Consulta la información de un bucket.

GetBucketLocation

oss:GetBucketLocation

Consulta la información de ubicación de un bucket.

GetBucketStat

oss:GetBucketStat

Obtiene la capacidad de almacenamiento y el número de archivos de un bucket.

PutBucketVersioning

oss:PutBucketVersioning

Configura el estado de control de versiones para un bucket específico.

GetBucketVersioning

oss:GetBucketVersioning

Obtiene el estado de control de versiones de un bucket específico.

ListObjectVersions (GetBucketVersions)

oss:ListObjectVersions

Enumera la información de versiones de todos los objetos en un bucket, incluidos los marcadores de eliminación.

PutBucketAcl

oss:PutBucketAcl

Establece o modifica la ACL de un bucket.

GetBucketAcl

oss:GetBucketAcl

Obtiene la ACL de un bucket.

DeleteBucket

oss:DeleteBucket

Elimina un bucket.

InitiateBucketWorm

oss:InitiateBucketWorm

Crea una directiva de retención.

AbortBucketWorm

oss:AbortBucketWorm

Elimina una directiva de retención desbloqueada.

CompleteBucketWorm

oss:CompleteBucketWorm

Bloquea una directiva de retención.

ExtendBucketWorm

oss:ExtendBucketWorm

Extiende el período de retención en días para los objetos de un bucket que tiene una directiva de retención bloqueada.

GetBucketWorm

oss:GetBucketWorm

Obtiene información sobre una directiva de retención.

PutBucketLogging

oss:PutBucketLogging

Habilita el almacenamiento de registros para un bucket.

oss:PutObject

Cuando se habilita el almacenamiento de registros para un bucket de origen, esta acción escribe los registros en el bucket de destino.

GetBucketLogging

oss:GetBucketLogging

Consulta la configuración de almacenamiento de registros de un bucket.

DeleteBucketLogging

oss:DeleteBucketLogging

Deshabilita el almacenamiento de registros para un bucket.

PutBucketWebsite

oss:PutBucketWebsite

Configura un bucket para hosting de sitios web estáticos y establece sus reglas de redirección (RoutingRule).

GetBucketWebsite

oss:GetBucketWebsite

Consulta el estado de hosting de sitio web estático y las reglas de redirección de un bucket.

DeleteBucketWebsite

oss:DeleteBucketWebsite

Deshabilita el hosting de sitio web estático para un bucket y borra sus reglas de redirección.

PutBucketReferer

oss:PutBucketReferer

Configura la protección contra hotlinking para un bucket.

GetBucketReferer

oss:GetBucketReferer

Consulta la configuración de protección contra hotlinking (Referer) de un bucket.

PutBucketLifecycle

oss:PutBucketLifecycle

Establece una regla de ciclo de vida para un bucket.

GetBucketLifecycle

oss:GetBucketLifecycle

Consulta la regla de ciclo de vida de un bucket.

DeleteBucketLifecycle

oss:DeleteBucketLifecycle

Elimina la regla de ciclo de vida de un bucket.

PutBucketTransferAcceleration

oss:PutBucketTransferAcceleration

Configura la aceleración de transferencia para un bucket.

GetBucketTransferAcceleration

oss:GetBucketTransferAcceleration

Consulta la configuración de aceleración de transferencia de un bucket.

ListMultipartUploads

oss:ListMultipartUploads

Enumera todos los eventos de carga multiparte en curso que se han iniciado pero no se han completado ni cancelado.

PutBucketCors

oss:PutBucketCors

Establece las reglas de uso compartido de recursos de origen cruzado (CORS) para un bucket específico.

GetBucketCors

oss:GetBucketCors

Obtiene las reglas CORS actuales para un bucket específico.

DeleteBucketCors

oss:DeleteBucketCors

Deshabilita la función CORS para un bucket específico y borra todas las reglas.

PutBucketPolicy

oss:PutBucketPolicy

Establece la directiva de autorización para un bucket específico.

GetBucketPolicy

oss:GetBucketPolicy

Obtiene la directiva de autorización de un bucket específico.

DeleteBucketPolicy

oss:DeleteBucketPolicy

Elimina la directiva de autorización de un bucket específico.

PutBucketTags

oss:PutBucketTagging

Agrega o modifica las etiquetas de un bucket específico.

GetBucketTags

oss:GetBucketTagging

Obtiene las etiquetas de un bucket.

DeleteBucketTags

oss:DeleteBucketTagging

Elimina las etiquetas de un bucket.

PutBucketEncryption

oss:PutBucketEncryption

Configura las reglas de cifrado para un bucket.

GetBucketEncryption

oss:GetBucketEncryption

Obtiene las reglas de cifrado de un bucket.

DeleteBucketEncryption

oss:DeleteBucketEncryption

Elimina las reglas de cifrado de un bucket.

PutBucketRequestPayment

oss:PutBucketRequestPayment

Configura el modo de pago por solicitante.

GetBucketRequestPayment

oss:GetBucketRequestPayment

Obtiene la configuración de pago por solicitante.

PutBucketReplication

oss:PutBucketReplication

Establece las reglas de replicación de datos para un bucket.

oss:ReplicateGet

Establece reglas de replicación de datos entre cuentas para un bucket o especifica un rol de RAM para la replicación.

PutBucketRTC

oss:PutBucketRTC

Habilita o deshabilita el control de tiempo de replicación (RTC) para una regla de cross-region replication existente.

GetBucketReplication

oss:GetBucketReplication

Obtiene las reglas de replicación de datos configuradas para un bucket.

DeleteBucketReplication

oss:DeleteBucketReplication

Detiene la replicación de datos para un bucket y elimina su configuración de replicación.

GetBucketReplicationLocation

oss:GetBucketReplicationLocation

Obtiene las regiones donde pueden ubicarse los buckets de destino para la replicación.

GetBucketReplicationProgress

oss:GetBucketReplicationProgress

Obtiene el progreso de la replicación de datos para un bucket.

PutBucketInventory

oss:PutBucketInventory

Configura reglas de inventario para un bucket.

GetBucketInventory

oss:GetBucketInventory

Consulta una tarea de inventario específica en un bucket.

ListBucketInventory

oss:GetBucketInventory

Obtiene todas las tareas de inventario de un bucket en una operación por lotes.

DeleteBucketInventory

oss:DeleteBucketInventory

Elimina una tarea de inventario específica en un bucket.

PutBucketAccessMonitor

oss:PutBucketAccessMonitor

Configura el estado de seguimiento de acceso para un bucket.

GetBucketAccessMonitor

oss:GetBucketAccessMonitor

Obtiene el estado de seguimiento de acceso de un bucket.

OpenMetaQuery

oss:OpenMetaQuery

Habilita la función de gestión de metadatos para un bucket.

GetMetaQueryStatus

oss:GetMetaQueryStatus

Obtiene la información del índice de metadatos para un bucket.

DoMetaQuery

oss:DoMetaQuery

Consulta objetos que coinciden con condiciones específicas y enumera la información ordenada por campos determinados.

CloseMetaQuery

oss:CloseMetaQuery

Deshabilita la función de gestión de metadatos para un bucket.

InitUserAntiDDosInfo

oss:InitUserAntiDDosInfo

Crea una instancia de Anti-DDoS for OSS.

UpdateUserAntiDDosInfo

oss:UpdateUserAntiDDosInfo

Cambia el estado de una instancia de Anti-DDoS for OSS.

GetUserAntiDDosInfo

oss:GetUserAntiDDosInfo

Consulta información sobre instancias de Anti-DDoS for OSS bajo una cuenta específica.

InitBucketAntiDDosInfo

oss:InitBucketAntiDDosInfo

Inicializa la protección para un bucket.

UpdateBucketAntiDDosInfo

oss:UpdateBucketAntiDDosInfo

Actualiza el estado de protección de un bucket.

ListBucketAntiDDosInfo

oss:ListBucketAntiDDosInfo

Obtiene una lista de información de protección para un bucket.

PutBucketResourceGroup

oss:PutBucketResourceGroup

Establece el resource group al que pertenece un bucket.

GetBucketResourceGroup

oss:GetBucketResourceGroup

Consulta el ID del resource group al que pertenece un bucket.

CreateCnameToken

oss:CreateCnameToken

Crea un CnameToken obligatorio para la verificación de propiedad del nombre de dominio.

GetCnameToken

oss:GetCnameToken

Obtiene un CnameToken creado.

PutCname

oss:PutCname

Vincula un nombre de dominio personalizado a un bucket.

yundun-cert:DescribeSSLCertificatePrivateKey

yundun-cert:DescribeSSLCertificatePublicKeyDetail

yundun-cert:CreateSSLCertificate

Vincula un certificado cuando se asocia un nombre de dominio personalizado a un bucket.

ListCname

oss:ListCname

Obtiene una lista de todos los nombres de dominio personalizados (Cnames) vinculados a un bucket.

DeleteCname

oss:DeleteCname

Elimina un Cname vinculado a un bucket.

PutStyle

oss:PutStyle

Establece un estilo de imagen.

GetStyle

oss:GetStyle

Obtiene un estilo de imagen.

ListStyle

oss:ListStyle

Enumera estilos de imagen.

DeleteStyle

oss:DeleteStyle

Elimina un estilo de imagen.

PutBucketArchiveDirectRead

oss:PutBucketArchiveDirectRead

Habilita o deshabilita el acceso en tiempo real a objetos Archive para un bucket.

GetBucketArchiveDirectRead

oss:GetBucketArchiveDirectRead

Comprueba si el acceso en tiempo real a objetos Archive está habilitado para un bucket.

CreateAccessPoint

oss:CreateAccessPoint

Crea un punto de acceso.

GetAccessPoint

oss:GetAccessPoint

Obtiene información sobre un único punto de acceso.

DeleteAccessPoint

oss:DeleteAccessPoint

Elimina un punto de acceso.

ListAccessPoints

oss:ListAccessPoints

Obtiene información sobre puntos de acceso a nivel de usuario y de bucket.

PutAccessPointPolicy

oss:PutAccessPointPolicy

Configura una directiva de punto de acceso.

GetAccessPointPolicy

oss:GetAccessPointPolicy

Obtiene información sobre una directiva de punto de acceso.

DeleteAccessPointPolicy

oss:DeleteAccessPointPolicy

Elimina una directiva de punto de acceso.

PutBucketHttpsConfig

oss:PutBucketHttpsConfig

Habilita o deshabilita la configuración de versión TLS para un bucket.

GetBucketHttpsConfig

oss:GetBucketHttpsConfig

Consulta la configuración de versión TLS para un bucket.

Ninguna

oss:ReplicateList

Permiso de listado para replicación. Permite que OSS enumere y replique datos históricos del bucket de origen.

CreateAccessPointForObjectProcess

oss:CreateAccessPointForObjectProcess

Crea un punto de acceso FC de objeto.

GetAccessPointForObjectProcess

oss:GetAccessPointForObjectProcess

Obtiene información básica sobre un punto de acceso FC de objeto.

DeleteAccessPointForObjectProcess

oss:DeleteAccessPointForObjectProcess

Elimina un punto de acceso FC de objeto.

ListAccessPointsForObjectProcess

oss:ListAccessPointsForObjectProcess

Obtiene información sobre puntos de acceso FC de objeto a nivel de usuario.

PutAccessPointConfigForObjectProcess

oss:PutAccessPointConfigForObjectProcess

Modifica la configuración de un punto de acceso FC de objeto.

GetAccessPointConfigForObjectProcess

oss:GetAccessPointConfigForObjectProcess

Obtiene la información de configuración de un punto de acceso FC de objeto.

PutAccessPointPolicyForObjectProcess

oss:PutAccessPointPolicyForObjectProcess

Configura una directiva de acceso para un punto de acceso FC de objeto.

GetAccessPointPolicyForObjectProcess

oss:GetAccessPointPolicyForObjectProcess

Obtiene la configuración de la directiva de acceso de un punto de acceso FC de objeto.

DeleteAccessPointPolicyForObjectProcess

oss:DeleteAccessPointPolicyForObjectProcess

Elimina la directiva de acceso de un punto de acceso FC de objeto.

WriteGetObjectResponse

oss:WriteGetObjectResponse

Personaliza los datos devueltos y los encabezados de respuesta.

CreateBucketDataRedundancyTransition

oss:CreateBucketDataRedundancyTransition

Crea una tarea de transición de redundancia de almacenamiento.

GetBucketDataRedundancyTransition

oss:GetBucketDataRedundancyTransition

Obtiene una tarea de transición de redundancia de almacenamiento.

DeleteBucketDataRedundancyTransition

oss:DeleteBucketDataRedundancyTransition

Elimina una tarea de transición de redundancia de almacenamiento.

ListBucketDataRedundancyTransition

oss:ListBucketDataRedundancyTransition

Enumera todas las tareas de transición de redundancia de almacenamiento en un bucket.

PutBucketPublicAccessBlock

oss:PutBucketPublicAccessBlock

Habilita Block Public Access para un bucket.

GetBucketPublicAccessBlock

oss:GetBucketPublicAccessBlock

Obtiene la configuración de Block Public Access de un bucket.

DeleteBucketPublicAccessBlock

oss:DeleteBucketPublicAccessBlock

Elimina la configuración de Block Public Access de un bucket.

PutAccessPointPublicAccessBlock

oss:PutAccessPointPublicAccessBlock

Habilita Block Public Access para un punto de acceso.

GetAccessPointPublicAccessBlock

oss:GetAccessPointPublicAccessBlock

Obtiene la configuración de Block Public Access de un punto de acceso.

DeleteAccessPointPublicAccessBlock

oss:DeleteAccessPointPublicAccessBlock

Elimina la configuración de Block Public Access de un punto de acceso.

GetBucketPolicyStatus

oss:GetBucketPolicyStatus

Comprueba si la directiva actual del bucket permite el acceso público.

PutBucketOverwriteConfig

oss:PutBucketOverwriteConfig

Configura el ajuste para no permitir sobrescritura en un bucket.

GetBucketOverwriteConfig

oss:GetBucketOverwriteConfig

Obtiene la configuración para no permitir sobrescritura de un bucket.

DeleteBucketOverwriteConfig

oss:DeleteBucketOverwriteConfig

Elimina la configuración para no permitir sobrescritura de un bucket.

Nivel de objeto

API

Action

Descripción de la API

PutObject

oss:PutObject

Carga un objeto.

oss:PutObjectTagging

Al cargar un objeto, utilice x-oss-tagging para especificar la etiqueta del objeto.

kms:GenerateDataKey

kms:Decrypt

Al cargar un objeto, especifique que los metadatos del objeto contengan X-Oss-Server-Side-Encryption: KMS.

PostObject

oss:PutObject

Carga un objeto en un bucket específico mediante un formulario HTML.

AppendObject

oss:PutObject

Carga un objeto mediante la anexión de datos.

oss:PutObjectTagging

Al cargar un objeto mediante la anexión de datos, utilice x-oss-tagging para especificar la etiqueta del objeto.

InitiateMultipartUpload

oss:PutObject

Inicializa una tarea de carga multiparte.

oss:PutObjectTagging

Al inicializar una tarea de carga multiparte, utilice x-oss-tagging para especificar la etiqueta del objeto.

kms:GenerateDataKey

kms:Decrypt

Al inicializar una tarea de carga multiparte, especifique que los metadatos del objeto contengan X-Oss-Server-Side-Encryption: KMS.

UploadPart

oss:PutObject

Carga datos en partes según el nombre de objeto y el uploadId especificados.

CompleteMultipartUpload

oss:PutObject

Una vez cargadas todas las partes, completa la carga multiparte de todo el objeto.

oss:PutObjectTagging

Una vez cargadas todas las partes, completa la carga multiparte de todo el objeto y especifica sus etiquetas.

AbortMultipartUpload

oss:AbortMultipartUpload

Cancela un evento de carga multiparte y elimina los datos de parte correspondientes.

PutSymlink

oss:PutObject

Crea un vínculo simbólico para un objeto de destino en OSS.

oss:PutObjectTagging

Crea un vínculo simbólico con una etiqueta de objeto específica para un objeto de destino en OSS.

GetObject

oss:GetObject

Obtiene un objeto.

kms:Decrypt

Descarga un objeto cifrado con una clave de KMS específica.

oss:GetObjectVersion

Descarga una versión específica de un objeto.

HeadObject

oss:GetObject

Obtiene los metadatos de un objeto.

GetObjectMeta

oss:GetObject

Obtiene los metadatos de un objeto, incluida su información de ETag, Size y LastModified.

SelectObject

oss:GetObject

Ejecuta una instrucción SQL en un objeto de destino y devuelve el resultado.

GetSymlink

oss:GetObject

Obtiene el vínculo simbólico de un objeto de destino.

DeleteObject

oss:DeleteObject

Elimina un objeto.

oss:DeleteObjectVersion

Elimina una versión específica de un objeto.

DeleteMultipleObjects

oss:DeleteObject

Elimina varios objetos del mismo bucket.

CopyObject

oss:GetObject

oss:PutObject

Copia un objeto entre buckets de la misma región. Los buckets pueden ser iguales o distintos.

oss:GetObjectVersion

Copia una versión específica de un objeto entre buckets de la misma región. Los buckets pueden ser iguales o distintos.

oss:GetObjectTagging

oss:PutObjectTagging

Copia un objeto con etiquetas específicas entre buckets de la misma región. Los buckets pueden ser iguales o distintos.

kms:GenerateDataKey

kms:Decrypt

Al copiar un objeto, especifique que los metadatos del objeto de destino contengan X-Oss-Server-Side-Encryption: KMS.

oss:GetObjectVersionTagging

Copia una versión de un objeto con etiquetas específicas entre buckets de la misma región. Los buckets pueden ser iguales o distintos.

UploadPartCopy

oss:GetObject

oss:PutObject

Copia datos de un objeto existente para cargar una parte al agregar el encabezado x-oss-copy-source a una solicitud UploadPart.

oss:GetObjectVersion

Copia datos de una versión específica de un objeto existente para cargar una parte al agregar el encabezado x-oss-copy-source a una solicitud UploadPart.

ListParts

oss:ListParts

Enumera todas las partes cargadas correctamente que pertenecen a un ID de carga específico.

PutObjectACL

oss:PutObjectAcl

Modifica la ACL de un objeto en un bucket.

oss:PutObjectVersionAcl

Modifica la ACL de una versión específica de un objeto en un bucket.

GetObjectACL

oss:GetObjectAcl

Obtiene la ACL de un objeto en un bucket.

oss:GetObjectVersionAcl

Obtiene la ACL de una versión específica de un objeto en un bucket.

RestoreObject

oss:RestoreObject

Restaura un objeto de la clase de almacenamiento Archive Storage, Cold Archive o Deep Cold Archive.

oss:RestoreObjectVersion

Restaura una versión específica de un objeto de la clase de almacenamiento Archive Storage, Cold Archive o Deep Cold Archive.

PutObjectTagging

oss:PutObjectTagging

Establece o actualiza la información de etiquetado de un objeto.

oss:PutObjectVersionTagging

Establece o actualiza la información de etiquetado de una versión específica de un objeto.

GetObjectTagging

oss:GetObjectTagging

Obtiene la información de etiquetado de un objeto.

oss:GetObjectVersionTagging

Obtiene la información de etiquetado de una versión específica de un objeto.

DeleteObjectTagging

oss:DeleteObjectTagging

Elimina la información de etiquetado de un objeto específico.

oss:DeleteObjectVersionTagging

Elimina la información de etiquetado de una versión específica de un objeto.

PutLiveChannel

oss:PutLiveChannel

Antes de cargar datos de audio y video mediante RTMP, llame a esta API para crear un LiveChannel.

ListLiveChannel

oss:ListLiveChannel

Enumera los LiveChannels especificados.

DeleteLiveChannel

oss:DeleteLiveChannel

Elimina un LiveChannel específico.

PutLiveChannelStatus

oss:PutLiveChannelStatus

Alterna el estado entre habilitado y deshabilitado.

GetLiveChannelInfo

oss:GetLiveChannel

Obtiene la información de configuración de un LiveChannel específico.

GetLiveChannelStat

oss:GetLiveChannelStat

Obtiene el estado de ingesta de flujo de un LiveChannel específico.

GetLiveChannelHistory

oss:GetLiveChannelHistory

Obtiene los registros de ingesta de flujo de un LiveChannel específico.

PostVodPlaylist

oss:PostVodPlaylist

Genera una lista de reproducción de video bajo demanda para un LiveChannel específico.

GetVodPlaylist

oss:GetVodPlaylist

Visualiza la lista de reproducción generada a partir de la ingesta de flujo para un LiveChannel específico dentro de un periodo de tiempo determinado.

Ninguna

oss:PublishRtmpStream

Envía flujos de datos de audio y video a RTMP.

Ninguna

oss:ProcessImm

Permiso para utilizar IMM en el procesamiento de datos a través de OSS.

PostProcessTask

oss:GetObject

Permiso para utilizar IMM en el procesamiento de datos mediante una solicitud POST.

oss:PutObject

Permiso para utilizar IMM en el procesamiento de datos Saveas.

ImgSaveAs

oss:PostProcessTask

Guarda la imagen procesada en un bucket específico.

CreateOfficeConversionTask

imm:CreateOfficeConversionTask

Permiso para utilizar IMM en la conversión de documentos o instantáneas.

GenerateWebofficeToken

imm: GenerateWebofficeToken

Obtiene un token de Weboffice.

RefreshWebofficeToken

imm:RefreshWebofficeToken

Actualiza un token de Weboffice.

Ninguna

oss:ReplicateGet

Permiso de lectura para replicación. Permite que OSS lea datos y metadatos de los buckets de origen y destino, incluidos objetos, partes y cargas multiparte.

Ninguna

oss:ReplicatePut

Permiso de escritura para replicación. Permite que OSS escriba objetos, cargas multiparte, partes y vínculos simbólicos, además de modificar metadatos en el bucket de destino.

Ninguna

oss:ReplicateDelete

Permiso de eliminación para replicación. Permite que OSS ejecute operaciones DeleteObject, AbortMultipartUpload y DeleteMarker en el bucket de destino.

Nota

Debe otorgar esta acción al rol de RAM únicamente cuando seleccione Sync All para la replicación de datos.

QoS del pool de recursos

API

Action

Descripción de la API

PutBucketQoSInfo

oss:PutBucketQoSInfo

Establece la limitación de velocidad para un bucket en un pool de recursos.

GetBucketQoSInfo

oss:GetBucketQoSInfo

Obtiene la configuración de limitación de velocidad para un bucket en un pool de recursos.

DeleteBucketQosInfo

oss:DeleteBucketQoSInfo

Elimina la configuración de limitación de velocidad para un bucket específico en un pool de recursos.

PutBucketRequesterQoSInfo

oss:PutBucketRequesterQoSInfo

Establece la limitación de velocidad a nivel de bucket para un solicitante.

GetBucketRequesterQoSInfo

oss:GetBucketRequesterQoSInfo

Obtiene la configuración de limitación de velocidad a nivel de bucket para un solicitante específico.

ListBucketRequesterQoSInfos

oss:ListBucketRequesterQoSInfo

Obtiene las configuraciones de limitación de velocidad a nivel de bucket para todos los solicitantes.

DeleteBucketRequesterQoSInfo

oss:DeleteBucketRequesterQoSInfo

Elimina la configuración de limitación de velocidad para un solicitante de un bucket.

ListResourcePools

oss:ListResourcePools

Obtiene información sobre todos los pools de recursos bajo la cuenta actual.

GetResourcePoolInfo

oss:GetResourcePoolInfo

Obtiene la configuración de limitación de velocidad de un pool de recursos específico.

ListResourcePoolBuckets

oss:ListResourcePoolBuckets

Obtiene la lista de buckets incluidos en un pool de recursos específico.

PutResourcePoolRequesterQoSInfo

oss:PutResourcePoolRequesterQoSInfo

Configura la limitación de velocidad para un solicitante de un pool de recursos.

GetResourcePoolRequesterQoSInfo

oss:GetResourcePoolRequesterQoSInfo

Obtiene la configuración de limitación de velocidad para un solicitante específico en un pool de recursos.

ListResourcePoolRequesterQoSInfos

oss:ListResourcePoolRequesterQoSInfos

Obtiene las configuraciones de limitación de velocidad para todos los solicitantes en un pool de recursos.

DeleteResourcePoolRequesterQoSInfo

oss:DeleteResourcePoolRequesterQoSInfo

Elimina la configuración de limitación de velocidad para un solicitante específico en un pool de recursos.

Bucket vectorial

API

Action

Descripción de la API

PutVectorBucket

oss:PutVectorBucket

Crea un bucket vectorial.

GetVectorBucket

oss:GetVectorBucket

Obtiene los detalles de un bucket vectorial.

ListVectorBuckets

oss:ListVectorBuckets

Enumera todos los buckets vectoriales propiedad del solicitante.

DeleteVectorBucket

oss:DeleteVectorBucket

Elimina un bucket vectorial.

PutBucketLogging

oss:PutBucketLogging

Habilita el almacenamiento de registros para un bucket vectorial.

oss:PutObject

Cuando se habilita el almacenamiento de registros para un bucket vectorial de origen, esta acción escribe los registros en el bucket de destino.

GetBucketLogging

oss:GetBucketLogging

Visualiza la configuración de almacenamiento de registros de un bucket vectorial.

DeleteBucketLogging

oss:DeleteBucketLogging

Deshabilita el almacenamiento de registros para un bucket vectorial.

PutBucketPolicy

oss:PutBucketPolicy

Establece la directiva de autorización para un bucket vectorial específico.

GetBucketPolicy

oss:GetBucketPolicy

Obtiene la directiva de autorización de un bucket vectorial específico.

DeleteBucketPolicy

oss:DeleteBucketPolicy

Elimina la directiva de autorización de un bucket vectorial específico.

PutVectorIndex

oss:PutVectorIndex

Crea un índice vectorial.

GetVectorIndex

oss:GetVectorIndex

Obtiene los detalles de un índice vectorial.

ListVectorIndexes

oss:ListVectorIndexes

Enumera todos los índices vectoriales en un bucket vectorial.

DeleteVectorIndex

oss:DeleteVectorIndex

Elimina un índice vectorial.

PutVectors

oss:PutVectors

Escribe datos vectoriales.

GetVectors

oss:GetVectors

Obtiene datos vectoriales específicos.

ListVectors

oss:ListVectors

Enumera todos los datos vectoriales en un índice vectorial.

QueryVectors

oss:QueryVectors

Realiza una búsqueda por similitud vectorial.

DeleteVectors

oss:DeleteVectors

Elimina datos vectoriales específicos de un índice vectorial.

Resource

El elemento Resource especifica uno o varios recursos. Utilice el asterisco (*) como comodín. Una sola directiva de bucket puede incluir varios recursos.

Bucket

Categoría

Formato

Ejemplo

Nivel de bucket

acs:oss:{region}:{bucket_owner_id}:{bucket_name}

acs:oss:*:*:example-bucket

Nivel de objeto

acs:oss:{region}:{bucket_owner_id}:{bucket_name}/{object_name}

acs:oss:*:*:example-bucket/abc.txt

Nivel de pool de recursos

acs:oss:{region}:{account_id}:resourcepool/{resource_pool_name}

acs:oss:*:*:resourcepool/resource-pool-for-ai

Vector bucket

Nivel de recurso

Formato

Ejemplo

Todos los recursos vectoriales

acs:ossvector:*:*:*

acs:ossvector:*:*:*

Vector bucket

acs:ossvector:{region}:{account_id}:{bucket_name}

acs:ossvector:*:*:my-vector-bucket

Índice vectorial

acs:ossvector:{region}:{account_id}:{bucket_name}/{index_name}

acs:ossvector:*:*:my-vector-bucket/myindex

Datos vectoriales

acs:ossvector:{region}:{account_id}:{bucket_name}/{index_name}/*

acs:ossvector:*:*:my-vector-bucket/myindex/*

Nota

Actualmente, el campo de región solo admite el asterisco comodín (*).

Condition

El elemento Condition especifica cuándo entra en vigor una directiva. Se compone de un operador de condición, una clave de condición y un valor de condición.

Operadores de condición

Tipo de operador de condición

Tipos compatibles

String

  • StringEquals

  • StringNotEquals

  • StringEqualsIgnoreCase

  • StringNotEqualsIgnoreCase

  • StringLike

  • StringNotLike

Number

  • NumericEquals

  • NumericNotEquals

  • NumericLessThan

  • NumericLessThanEquals

  • NumericGreaterThan

  • NumericGreaterThanEquals

Fecha y hora

  • DateEquals

  • DateNotEquals

  • DateLessThan

  • DateLessThanEquals

  • DateGreaterThan

  • DateGreaterThanEquals

Boolean

Bool

Tipo de dirección IP

  • IpAddress

  • NotIpAddress

  • IpAddressIncludeBorder

Claves de condición

Clave de condición

Descripción

acs:SourceIp

Especifica un bloque CIDR de IP estándar. Admite el asterisco comodín (*).

acs:SourceVpc

Especifica la VPC. El valor puede ser un ID de VPC específico o vpc-*.

Nota

Al utilizar acs:SourceVpc para restringir el acceso por VPC de origen, asegúrese de que la región de la VPC coincida con una región donde OSS admita endpoints de puerta de enlace. De lo contrario, las solicitudes de autenticación no podrán asociarse con la VPC correcta y fallarán. Regions where OSS supports gateway endpoints.

acs:UserAgent

Especifica el encabezado HTTP User-Agent.

Tipo: string.

acs:CurrentTime

La hora a la que la solicitud llega al servidor de OSS.

Formato: ISO 8601.

acs:SecureTransport

El tipo de protocolo de la solicitud. Valores válidos:

  • true: Solo se permiten solicitudes HTTPS.

  • false: Solo se permiten solicitudes HTTP.

Si no se establece acs:SecureTransport, se permiten tanto HTTP como HTTPS.

oss:x-oss-acl

Restringe el tipo de ACL del bucket. Valores válidos:

  • private: Privado.

  • public-read: Lectura pública.

  • public-read-write: Lectura y escritura públicas.

Bucket ACL.

oss:x-oss-object-acl

Restringe el tipo de ACL del objeto. Valores válidos:

  • private: privado.

  • public-read: Lectura pública.

  • public-read-write: Lectura y escritura públicas.

  • default: Hereda la ACL del bucket.

Object ACL.

oss:Prefix

Lista objetos con un prefijo especificado en una solicitud ListObjects.

oss:Delimiter

Agrupa nombres de objetos en una solicitud ListObjects.

acs:AccessId

El AccessId incluido en la solicitud.

oss:BucketTag

Una etiqueta de bucket.

Se puede usar una sola BucketTag como condición. Cuando establezca varias BucketTags, debe agregar el prefijo oss:BucketTag/ a cada BucketTag para formar múltiples condiciones.

acs:MFAPresent

Especifica si la autenticación multifactor (MFA) está habilitada.

Valores:

  • true: MFA está habilitada.

  • false: MFA no está habilitada.

oss:ExistingObjectTag

El objeto solicitado ya tiene etiquetas.

Se puede usar una sola ObjectTag como condición. Cuando utilice varias ObjectTags, debe agregar oss:ExistingObjectTag/ antes de cada ObjectTag.

Esto aplica principalmente a las API para leer archivos, como GetObject y HeadObject, y a las API de ObjectTagging, como PutObjectTagging y GetObjectTagging.

oss:RequestObjectTag

Las etiquetas de objeto incluidas en la solicitud.

Se puede usar una sola etiqueta de objeto como condición. Cuando se especifican varias etiquetas de objeto, debe agregar oss:RequestObjectTag/ antes de cada etiqueta de objeto.

Esto aplica principalmente a operaciones de API para escribir archivos, como PutObject y PostObject, y a operaciones de API de ObjectTagging, como PutObjectTagging y GetObjectTagging.

Referencias