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.
Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Configuración avanzada del bucket/ Obtención de la configuración de notificación de evento de un bucket
Actualización más reciente 2023-07-11 GMT+08:00
Ver PDF

Obtención de la configuración de notificación de evento de un bucket

Funciones

Esta operación obtiene la configuración de notificación de un bucket.

Para realizar esta operación, debe tener el permiso GetBucketNotification. 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 o la política de usuario.

Sintaxis de solicitud

1
2
3
 
GET /?notification HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Date: date
Authorization: authorization

Parámetros de solicitud

Esta solicitud no contiene ningún parámetro.

Encabezados de solicitud

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

Elementos de solicitud.

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 
HTTP/1.1 status_code
Content-Type: type
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8"?> 
<NotificationConfiguration xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
 
    <TopicConfiguration>  
        <Id>ConfigurationId</Id>  
        <Filter>  
            <Object>  
                <FilterRule>  
                    <Name>prefix</Name>  
                    <Value>prefix-value</Value>  
                </FilterRule>  
                <FilterRule>  
                    <Name>suffix</Name>  
                    <Value>suffix-value</Value>  
                </FilterRule>  
           </Object>  
        </Filter>  
        <Topic>TopicARN</Topic>  
        <Event>event-type</Event>  
        <Event>event-type</Event>  
        ...  
    </TopicConfiguration>  
</NotificationConfiguration>

Encabezados de respuesta

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

Elementos de respuesta

Esta respuesta contiene elementos para detallar la configuración. Tabla 1 describe los elementos.

Tabla 1 Elementos de respuesta para configurar la notificación de eventos

Elemento

Descripción

NotificationConfiguration

Elemento para configurar la función de notificación de eventos de un bucket. Si este elemento es null, la función está deshabilitada.

Tipo: element

Antepasado: ninguno

Hijos: uno o más

TopicConfiguration

TopicConfiguration

Elemento para configurar el tema de notificación de evento.

Tipo: element

Antepasado: NotificationConfiguration

Hijos: Id, Filter, Topic, Event, or Events

Topic

URN del tema de notificación de evento. Después de detectar un evento específico en el bucket, OBS envía un mensaje al tema.

Tipo: string

Antepasado: TopicConfiguration

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:

TopicConfiguration

Filter

Elemento utilizado para almacenar reglas de filtrado de nombres de objeto.

Tipo: element

Antepasado:

TopicConfiguration

Hijos: Object

Object

Elemento utilizado para almacenar reglas de filtrado de nombres de objeto.

Tipo: element

Antepasado:

TopicConfiguration

FilterRule

Elemento que define los pares clave-valor de la regla de filtrado.

Tipo: element

Antepasado: Object

Hijos: Name, Value

Name

Prefijo o sufijo de nombres de objeto para filtrar

Tipo: string

Antepasado: FilterRule

Opciones de valor: prefix, suffix

Value

Palabras clave de nombres de objetos para que los objetos se puedan filtrar en función de los prefijos o sufijos

Tipo: string

Antepasado: FilterRule

Event

Tipo de eventos que deben ser notificados

NOTA:

Se pueden agregar varios tipos de eventos en un elemento TopicConfiguration.

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:

TopicConfiguration

Respuestas de error

No hay respuestas de error especiales involucradas. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Modelo de solicitud

1
2
3
4
5
6
 
GET /?notification HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 03:16:32 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:r5+2zwPTKwupMg6lkeTUUqPcHfQ=

Modelo de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 900B000001643FDDD751B37BA87590D8
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSJRBSladTn5ZCVw6ZIY/DAs0zs6z7Hh
Content-Type: application/xml
Date: WED, 01 Jul 2015 03:16:32 GMT
Content-Length: 490

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<NotificationConfiguration xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
 
  <TopicConfiguration>
    <Topic>urn:smn:region:4b29a3cb5bd64581bda5714566814bb7:tet522</Topic>
    <Id>ConfigurationId</Id>
    <Filter>
      <Object>
        <FilterRule>
          <Name>prefix</Name>
          <Value>object</Value>
        </FilterRule>
        <FilterRule>
          <Name>suffix</Name>
          <Value>txt</Value>
        </FilterRule>
      </Object>
    </Filter>
    <Event>ObjectCreated:Put</Event>
  </TopicConfiguration>
</NotificationConfiguration>