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/ Visão geral de API

Atualizado em 2022-11-18 GMT+08:00

Ver PDF

Visão geral de API

Operações de API em buckets

**Tabela 1** Operações de API em buckets
Operação	Descrição
Listagem de buckets	Consulta a lista de buckets criados pelo usuário.
Criação de um bucket	Cria um bucket. Você pode adicionar diferentes cabeçalhos de solicitação para especificar a região, classe de armazenamento, e a política de controle de permissão.
Listagem de objetos em um bucket	Lista objetos em um bucket. Você pode adicionar diferentes cabeçalhos de solicitação para obter objetos que correspondam ao prefixo, identificador e outros requisitos especificados.
Obtenção de metadados de um bucket	Verifica se os metadados do bucket existem. Você pode consultar as informações sobre a região do bucket, classe de armazenamento, número da versão do OBS, ID do projeto empresarial, e a configuração CORS.
Obtenção de localização de um bucket	Obtém as informações da região do bucket.
Exclusão de buckets	Exclui um bucket especificado. Antes de excluir um bucket, verifique se o bucket está vazio.

Operações de API em configurações avançadas de bucket

**Tabela 2** Operações de API em configurações avançadas de bucket
Operação	Descrição
Configuração de uma política de bucket	Cria ou modificar uma política de bucket. Se o bucket especificado já tiver uma política, a política na solicitação substituirá a existente.
Obtenção das informações de política de um bucket	Obtém as informações de política de um bucket especificado.
Exclusão de uma política de bucket	Exclui a política de um bucket especificado.
Configuração de uma ACL de bucket	Configura a ACL de um bucket especificado. Você pode controlar as permissões de leitura e gravação de um bucket por meio das configurações de ACL.
Obtenção das informações de ACL de um bucket	Obtém as informações ACL de um bucket especificado.
Configuração de registração para um bucket	Ativa ou desativa a função de gerenciamento de logs de um bucket. Quando esta função é ativada, um registro de log é gerado para cada operação em um bucket. Vários registros de log são compactados em um arquivo de log, que será salvo em um local especificado.
Obtenção da configuração de registração de um bucket	Obtém a configuração de registro do bucket atual.
Configuração de regras de ciclo de vida de um bucket	Configura regras para excluir ou migrar objetos automaticamente em um bucket.
Obtenção da configuração do ciclo de vida de um bucket	Obtém as regras de ciclo de vida configuradas para um bucket especificado.
Exclusão das regras do ciclo de vida	Exclui a configuração do ciclo de vida de um bucket.
Configuração do versionamento para um bucket	Ativa ou desativa o controle de versão para um bucket. Quando esta função está ativada, objetos de diferentes versões podem ser recuperados e restaurados, e os dados podem ser rapidamente restaurados em caso de operações acidentais ou falhas de aplicação.
Obtenção do status de versionamento do bucket	Obtém o status de versionamento de um bucket especificado.
Configuração da notificação de evento para um bucket	Configura a notificação de eventos de um bucket para garantir que o proprietário do bucket seja notificado sobre eventos que ocorrem no bucket de maneira segura e oportuna.
Obtenção da configuração de notificação de eventos de um bucket	Obtém a configuração de notificação de um bucket.
Configuração da classe de armazenamento para um bucket	Cria ou atualiza a configuração de classe de armazenamento padrão de um bucket.
Obtenção das informações da classe de armazenamento de um bucket	Obtém a configuração padrão da classe de armazenamento de um bucket.
Configuração da replicação entre regiões para um bucket	Configura a função de replicação entre regiões para um bucket. Ao ativar a função de replicação entre regiões, o OBS pode copiar novos objetos e objetos modificados de um bucket de origem para intervalos de destino em diferentes regiões.
Obtenção da configuração de replicação entre regiões de um bucket	Obtém a configuração de replicação entre regiões de um bucket especificado.
Exclusão da configuração de replicação entre regiões de um bucket	Exclui a configuração de replicação entre regiões de um bucket especificado.
Configuração de tags para um bucket	Adiciona uma tag a um bucket existente. Depois que as tags forem adicionadas a um bucket, todos os registros de dados de cobrança (os CDR) gerados pelas solicitações desse bucket terão as mesmas tags. Assim, os relatórios de CDR podem ser categorizados para análise detalhada de custos.
Obtenção de tags de um bucket	Obtém as tags de um bucket especificado.
Exclusão de tags	Exclui as tags de um bucket especificado.
Configuração da cota de armazenamento de um bucket	Define a cota de espaço do bucket para limitar a capacidade máxima de armazenamento do bucket.
Consulta da cota de armazenamento de um bucket	Obtém a cota de espaço do bucket.
Consulta das informações sobre o espaço usado em um bucket	Obtém o número de objetos em um bucket e o espaço ocupado pelos objetos.
Configuração de inventários de um bucket	Configura uma regra de inventário para um bucket. O OBS fornece inventários de bucket para facilitar o gerenciamento de objetos em um bucket. Você pode configurar inventários de bucket para listar periodicamente objetos em um bucket. Durante a listagem de objetos, os metadados do objeto são salvos em um arquivo CSV, que é carregado no bucket especificado.
Obtenção de inventários de um bucket	Obtém uma regra de inventário de um período especificado.
Listagem de inventários de um bucket	Obtém todas as regras de inventário de um período especificado.
Exclusão de inventários de um bucket	Exclui uma regra de inventário de um bucket especificado.
Configuração de um nome de domínio personalizado para um bucket	Configura um nome de domínio personalizado para um bucket. Depois que um nome de domínio definido pelo usuário é configurado com êxito, o bucket pode ser acessado por meio do nome de domínio definido pelo usuário.
Obtenção do nome de domínio personalizado de um bucket	Consulta o nome de domínio personalizado de um bucket.
Exclusão do nome de domínio personalizado de um bucket	Exclui o nome de domínio personalizado de um bucket.
Configuração da encriptação de um bucket	Cria ou atualiza a configuração de criptografia padrão do lado do servidor para um bucket. Depois que a criptografia é ativada para um bucket, os objetos carregados no bucket são criptografados com a configuração de criptografia do bucket.
Obtenção da configuração de encriptação de um bucket	Consulta a configuração padrão de criptografia do lado do servidor de um bucket.
Exclusão da configuração de encriptação de um bucket	Exclui a configuração padrão de criptografia do lado do servidor de um bucket.
Definição da política de leitura direta para objetos de Arquivo em um bucket	Ativa ou desativa a leitura direta para objetos de Arquivo de um bucket. Quando essa função está ativada, os objetos de Arquivo podem ser baixados sem serem restaurados antecipadamente.
Obtenção da política de leitura direta para objetos de Arquivo em um bucket	Obtém o status de leitura direta de objetos de Arquivo de um bucket especificado.
Exclusão da política de leitura direta para objetos de Arquivo em um bucket	Exclui a configuração de leitura direta de objetos de Arquivo de um bucket especificado.
Configuração de regras de volta à fonte do espelhamento	Configura regras de espelhamento back-to-source para um bucket.
Obtenção de regras de volta à fonte do espelhamento	Obtém espelhamento de regras back-to-source de um bucket.
Exclusão de regras de volta à fonte do espelhamento	Exclui as regras de espelhamento back-to-source de um bucket.
Definição de uma política de descompactação online	Configura as regras de descompactação para arquivos ZIP em um bucket especificado.
Obtenção de uma política de descompactação online	Obtém as regras de descompactação para arquivos ZIP em um bucket especificado.
Exclusão de uma política de descompactação online	Exclui as regras de descompactação para arquivos ZIP em um bucket especificado.

Operações de API para Hospedagem de Sites Estáticos

**Tabela 3** Operações de API para Hospedagem de Sites Estáticos
Operação	Descrição
Configuração da hospedagem de site estático para um bucket	Cria ou atualiza a configuração de hospedagem de sites de um bucket. OBS permite armazenar recursos estáticos de páginas da Web, como páginas da Web HTML, arquivos flash, vídeos e áudios em um bucket. Quando um cliente acessa esses recursos a partir do endpoint do site do bucket, o navegador pode resolver diretamente e apresentar os recursos ao cliente.
Obtenção da configuração de hospedagem de site estático de um bucket	Obtém a configuração de hospedagem de sites de um bucket.
Exclusão da configuração de hospedagem de site estático de um bucket	Exclui a configuração de hospedagem de sites de um bucket.
Configuração CORS de um bucket	Configura a configuração de compartilhamento de recursos de origem cruzada (CORS) de um bucket. O OBS permite que os recursos estáticos de páginas da Web sejam armazenados em intervalos. Os buckets podem ser usados como recursos do site. Um site hospedado pelo OBS pode responder a solicitações entre domínios de outro site somente após a configuração da regra CORS.
Obtenção da configuração CORS de um bucket	Obtém a configuração CORS de um bucket.
Exclusão da configuração CORS de um bucket	Exclui a configuração CORS de um bucket.
OPTIONS Bucket	Verifica se o cliente tem permissão para executar operações no servidor. Geralmente é realizado antes do acesso cross-domain.
OPTIONS Objeto	Verifica se o cliente tem permissão para executar operações no servidor. Geralmente é realizado antes do acesso cross-domain.

Operações de API em objetos

**Tabela 4** Operações de API em objetos
Operação	Descrição
Carregamento de objetos - PUT	Carrega objetos simples para um bucket especificado.
Carregamento de objetos - POST	Carrega objetos para um bucket especificado com base em tabelas.
Cópia de objetos	Cria uma cópia para um objeto existente no OBS.
Download de objetos	Baixa objetos.
Consulta de metadados de objeto	Obtém os metadados de objeto. Informações como tempo de expiração do objeto, número da versão e configuração CORS são os metadados do objeto.
Exclusão de um objeto	Exclui um objeto especificado. Você também pode levar o campo versionId para excluir a versão do objeto especificada.
Exclusão de objetos	Exclui um lote de objetos de um bucket permanentemente. Objetos excluídos dessa maneira não podem ser recuperados.
Restauração de objetos em Arquivo	Restaura objetos de Arquivo. Esses objetos devem ser restaurados antes que possam ser baixados.
Anexação de um objeto	Anexa dados a um objeto em um bucket especificado. Se nenhum objeto com o mesmo valor de chave existir no bucket, um novo objeto será criado.
Configuração de uma ACL de objeto	Configura a ACL de um objeto especificado. Você pode controlar as permissões de leitura e gravação de objetos por meio de configurações de ACL.
Obtenção da configuração ACL de um objeto	Obtém a configuração ACL de um objeto especificado.
Modificação de metadados de um objeto	Adiciona, modifica ou exclui metadados de objetos carregados.
Modificação de um objeto	Modifica o conteúdo de um objeto em um sistema de arquivos paralelo especificado a partir do local especificado.
Truncamento de um objeto	Trunca um objeto em um sistema de arquivos paralelo especificado para o tamanho especificado.
Renomeação de um objeto	Renomeia um objeto em um sistema de arquivos paralelo especificado.

Operações de API para tarefas de multiparte

**Tabela 5** Operações de API para tarefas de multiparte
Operação	Descrição
Listagem das tarefas de multiparte inicializadas em um bucket	Consulta todas as tarefas de carregamento de multiparte que não foram mescladas ou canceladas em um bucket.
Inicialização de uma tarefa de multiparte	Inicia uma tarefa de carregamento de multiparte e obtém o ID de tarefa de carregamento de multiparte globalmente exclusivo para operações subsequentes, como carregamento, mescla e listagem de partes.
Carregamento de multiparte	Carrega peças para uma tarefa de multiparte específica.
Carregamento de uma parte de um objeto - copiar	Copia um objeto ou uma parte do objeto como parte de uma tarefa de várias partes.
Listagem das partes carregadas de um objeto	Consulta informações sobre todas as partes de uma tarefa com várias partes.
Mescla das partes em um objeto completo	Mescla as partes especificadas em um objeto completo.
Cancelamento de uma tarefa de carregamento de multiparte	Cancela uma tarefa de carregamento de multiparte.