Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Configurações avançadas de bucket/ Obtenção da configuração de notificação de eventos de um bucket
Atualizado em 2022-11-07 GMT+08:00

Obtenção da configuração de notificação de eventos de um bucket

Funções

Esta operação obtém a configuração de notificação de um bucket.

Para executar essa operação, você deve ter a permissão GetBucketNotification. Por padrão, a permissão é concedida somente ao proprietário do bucket. No entanto, ele pode ser concedido a outros usuários configurando a política de bucket ou a política de usuário.

Sintaxe da solicitação

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

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

 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>

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Essa resposta contém elementos para detalhar a configuração. Tabela 1 descreve os elementos.

Tabela 1 Elementos de resposta para configurar a notificação de eventos

Elemento

Descrição

NotificationConfiguration

Elemento para configurar a função de notificação de eventos de um bucket. Se este elemento é null, a função é desativada.

Tipo: elemento

Antepassado: nenhum

Filhos: um ou mais

TopicConfiguration

TopicConfiguration

Elemento para configurar o tópico de notificação de evento.

Tipo: elemento

Antepassado: NotificationConfiguration

Crianças: Id, Filtro, Tópico, Evento ou Eventos

Topic

URN do tópico de notificação de evento. Depois de detectar um evento específico no bucket, o OBS envia uma mensagem para o tópico.

Tipo: string

Antepassado: TopicConfiguration

Id

ID exclusivo de cada notificação de evento. Se o usuário não especificar uma ID, o sistema atribuirá uma ID automaticamente.

Tipo: string

Antepassado:

TopicConfiguration

Filter

Elemento usado para armazenar regras de filtragem de nomes de objetos.

Tipo: elemento

Antepassado:

TopicConfiguration

Crianças: Objeto

Object

Elemento usado para armazenar regras de filtragem de nomes de objetos.

Tipo: elemento

Antepassado:

TopicConfiguration

FilterRule

Elemento que define pares chave-valor da regra de filtragem.

Tipo: elemento

Antepassado: Objeto

Crianças: Nome, Valor

Name

Prefixo ou sufixo de nomes de objetos para filtragem

Tipo: string

Antepassado: FilterRule

Opções de valor: prefixo, sufixo

Value

Palavras-chave de nomes de objetos para que os objetos possam ser filtrados com base nos prefixos ou sufixos

Tipo: string

Antepassado: FilterRule

Event

Tipo de eventos que precisam ser notificados

NOTA:

Vários tipos de evento podem ser adicionados em um item TopicConfiguration.

Tipo: string

Opções de valor:

Os seguintes valores podem ser usados para carregar um objeto:

  • ObjectCreated:Put
  • ObjectCreated:Post
  • ObjectCreated:Copy
  • ObjectCreated:CompleteMultipartUpload

Ou use caracteres curinga para suportar todas as operações de carregamento:

  • ObjectCreated:*

Os seguintes valores podem ser usados para excluir um objeto:

  • ObjectRemoved:Delete
  • ObjectRemoved:DeleteMarkerCreated

Ou use caracteres curinga para suportar todas as operações de exclusão:

  • ObjectRemoved:*

Antepassado:

TopicConfiguration

Respostas de erro

Nenhuma resposta de erro especial está envolvida. Para obter detalhes sobre respostas de erro, consulte Tabela 2.

Solicitação de exemplo

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=

Resposta de exemplo

 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>