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

Ver PDF

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

    
         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

    
     
       
       
         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

    
         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

    
     
       
       
         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>

        

      

    
   