Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

En esta página

Funciones
Sintaxis de solicitud
Parámetros de solicitud
Encabezados de solicitud
Elementos de solicitud
Sintaxis de respuesta
Encabezados de respuesta
Elementos de respuesta
Respuestas de error
Modelo de solicitud
Modelo de respuesta

Mostrar todo

Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Configuración avanzada del bucket/ Configuración de Notificación de Evento para un Bucket

Configuración de Notificación de Evento para un Bucket

Actualización más reciente 2024-09-18 GMT+08:00

Ver PDF

Funciones

Esta operación notifica a los usuarios de sus operaciones en los bucket, lo que permite a los usuarios saber los eventos ocurridos en los bucket de manera oportuna.

De forma predeterminada, la función de notificación de un bucket no está habilitada y el elemento NotificationConfiguration es null. Si desea deshabilitar la función, establezca el elemento NotificationConfiguration en null.

    
       <NotificationConfiguration>
</NotificationConfiguration>

Después de recibir una solicitud para configurar la notificación de evento, OBS verifica si existe el tema SMN especificado y si el tema está autorizado a OBS. Si el tema existe y está autorizado a OBS, OBS envía una notificación de prueba al suscriptor del tema.

Para realizar esta operación, debe tener el permiso PutBucketNotification. De forma predeterminada, el permiso se concede únicamente al propietario del bucket. Sin embargo, se puede conceder a otros usuarios configurando la política de bucket.

NOTA:

1. Para obtener más información acerca de cómo conceder temas a OBS, consulte Configuración de políticas de temas.

2. El cuerpo de una solicitud de SMN no puede superar los 100 KB de tamaño.

3. Un cuerpo de solicitud puede contener un máximo de 100 elementos de TopicConfig.

Sintaxis de solicitud

    
       PUT /?notification HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Date: date
Authorization: authorization string

<NotificationConfiguration>  
 
</NotificationConfiguration>

Parámetros de solicitud

Esta solicitud no contiene parámetros de mensaje.

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 3.

Elementos de solicitud

Esta solicitud contiene elementos para especificar la configuración de notificación para el bucket en formato XML. Para obtener más información sobre los elementos de configuración, consulte Tabla 1.

**Tabla 1** Elementos de solicitud para la configuración de la función de notificación
Elemento	Descripción	Obligatorio
NotificationConfiguration	Elemento raíz para configurar la función de notificación de eventos de un bucket. Si el subelemento es null, la función está deshabilitada. Tipo: container Antepasado: ninguno Hijos: cero o múltiples elementos de	Sí
Id	ID único de cada notificación de evento. Si el usuario no especifica un ID, el sistema asigna un ID automáticamente. Tipo: string Antepasado:	No
Filter	Elemento utilizado para almacenar reglas de filtrado de nombres de objeto. Tipo: container Antepasado: Hijos: Object	No
Object	Elemento que define la regla de filtrado. La regla filtra los objetos basándose en los prefijos y sufijos de los nombres de objeto. Tipo: container Antepasado: Filter Hijos: uno o más FilterRules	No
FilterRule	Elemento que define los pares clave-valor de la regla de filtrado Tipo: container Antepasado: Object Hijos: Name, Value	No
Name	Prefijo o sufijo de nombres de objeto para filtrar Tipo: string Antepasado: FilterRule Opciones de valor: prefix, suffix	No
Value	Palabra clave de los nombres de objetos. En función del prefijo o sufijo definido por Name, introduzca la palabra clave para filtrar objetos. Una string más larga de caracteres proporciona un resultado de filtrado más preciso. Se admite un máximo de 1024 caracteres. Tipo: string Antepasado: FilterRule	No
Event	Tipo de eventos que deben ser notificados NOTA: Se pueden agregar varios tipos de eventos en un elemento de . Tipo: string Opciones de valor: Se pueden utilizar los siguientes valores para cargar un objeto: ObjectCreated:Put ObjectCreated:Post ObjectCreated:Copy ObjectCreated:CompleteMultipartUpload O utilice caracteres comodín para admitir todas las operaciones de carga: ObjectCreated:* Se pueden utilizar los siguientes valores para eliminar un objeto: ObjectRemoved:Delete ObjectRemoved:DeleteMarkerCreated O utilice caracteres comodín para admitir todas las operaciones de eliminación: ObjectRemoved:* Antepasado:	Requerido si se agrega

Sintaxis de respuesta

    
       HTTP/1.1 status_code
Date: date
Content-Length: length
Content-Type: type

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta no contiene elementos.

Respuestas de error

Cuando se llama a esta operación, el sistema comprueba si el elemento NotificationConfiguration es válido y si la configuración es válida. En la siguiente tabla se enumeran los errores comunes y las posibles causas de esta operación.

**Tabla 2** Códigos de error y posibles causas
Código de error	Descripción	Código de estado de HTTP
InvalidArgument	Las posibles causas de este error son: No se admite el evento especificado. El URN especificado no existe o es incorrecto. La región especificada en el URN es diferente a la región donde reside el bucket. Las reglas de filtrado especificadas se superponen.	400 Bad Request (400: Solicitud errónea)
AccessDenied	El operador no es el propietario del bucket y no se le ha concedido el permiso PutBucketNotification.	403 Forbidden (403: Prohibido)

Modelo de solicitud

    
     
       
       PUT /?notification HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 03:15:45 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:uRTt8YTkAqJCUfWfYkveEcIGAC0=
Content-Length: 538

<NotificationConfiguration> 
  <> 
    <Id>ConfigurationId</Id>  
    <Filter>
      <Object>
        <FilterRule>
          <Name>prefix</Name>
          <Value>object</Value>
        </FilterRule>
        <FilterRule>
          <Name>suffix</Name>
          <Value>txt</Value>
        </FilterRule>
      </Object> 
    </Filter>  
    <Topic>urn:smn:region:4b29a3cb5bd64581bda5714566814bb7:tet555</Topic>  
    <Event>ObjectCreated:Put</Event> 
  </>
</NotificationConfiguration>

      

    
   

Modelo de respuesta

    
       HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 9046000001643C8E80C19FAC4D8068E3
x-obs-id-2: 32AAAQAAEAABSAAkgAIAABAAAQAAEAABCTFAxJPTib3GkcQ7nVVs4C8Z6NNcfVDu
Date: WED, 01 Jul 2015 03:15:46 GMT
Content-Length: 0

Tema principal: Configuración avanzada del bucket

Tema anterior: Obtención del estado de control de versiones del bucket

Tema siguiente: Obtención de la configuración de notificación de evento de un bucket

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar