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 2024-09-18 GMT+08:00

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 parámetros de mensaje.

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
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/">
 
</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 notificaciones 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: container

Antepasado: ninguno

Hijos: uno o más elementos de

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:

Filter

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

Tipo: container

Antepasado:

Hijos: Object

Object

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

Tipo: container

Antepasado:

FilterRule

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

Tipo: container

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 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:

Respuestas de error

No se devuelven respuestas de error especiales. 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: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSJRBSladan5ZCVw6ZIY/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/">
 
  <>
    <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>
  </>
</NotificationConfiguration>