Partilhar via


Configurar a API REST de objetos nos Arquivos NetApp do Azure (pré-visualização)

Os Arquivos NetApp do Azure dão suporte ao acesso a objetos do S3 com o recurso de object REST API. Com o recurso de API REST do objeto, você pode se conectar a serviços, incluindo Azure AI Search, Azure AI Foundry, Azure Databricks, OneLake e outros.

Registar a funcionalidade

O recurso de API REST do objeto nos Arquivos NetApp do Azure está atualmente em pré-visualização. Você deve enviar uma solicitação de lista de espera para usar o recurso de API REST do objeto. A ativação demora aproximadamente uma semana. Uma notificação por e-mail é enviada para confirmar a sua inscrição na pré-visualização.

Criar o certificado autoassinado

Você deve gerar um certificado SSL formatado em PEM. Você pode criar o certificado SSL no portal do Azure ou com um script.

Consulte a documentação do Azure Key Vault para adicionar um certificado ao Key Vault.

Ao criar o certificado, certifique-se:

  • o Tipo de Conteúdo está definido como PEM
  • o campo Assunto é definido como o endereço IP ou FQDN (nome de domínio totalmente qualificado) do ponto de extremidade dos Arquivos NetApp do Azure usando o formato "CN=<IP or FQDN>"
  • a entrada DNS Names especifica o endereço IP ou FQDN

Captura de tela de opções de criação de certificado.

Criar um bucket

Para habilitar a API REST do objeto, você deve criar um bucket.

  1. A partir do seu volume NetApp, selecione Buckets.

  2. Para criar um bucket, selecione +Criar.

  3. Forneça as seguintes informações para o bucket:

    • Nome

      Especifique o nome do bucket. Consulte Regras e restrições de nomenclatura para recursos do Azure para convenções de nomenclatura.

    • Path

      O caminho do subdiretório para a API REST do objeto. Para acesso completo ao volume, deixe este campo em branco ou use / para o diretório raiz.

    • ID de utilizador (UID)

      O UID utilizado para leitura do bucket.

    • ID do Grupo (GID)

      O GID costumava ler o balde.

    • Permissões

      Selecione Ler ou Ler-Escrever.

    Captura de ecrã do menu de criação de bucket.

  4. Se você não forneceu um certificado, carregue seu arquivo PEM.

    Para carregar um certificado, forneça as seguintes informações:

    • Nome de domínio totalmente qualificado

      Insira o nome de domínio totalmente qualificado.

    • Origem do certificado

      Carregue o certificado apropriado. Apenas os ficheiros PEM são suportados.

    Selecione Guardar.

  5. Selecione Criar.

Depois de criar um bucket, você precisa gerar credenciais para acessar o bucket.

Atualizar o acesso ao bucket

Você pode modificar as configurações de gerenciamento de acesso de um bucket.

  1. A partir do seu volume NetApp, selecione Buckets.
  2. Selecione +Criar.
  3. Digite o nome do bucket que você deseja modificar.
  4. Altere as configurações de gerenciamento de acesso conforme necessário.
  5. Você pode modificar a ID de usuário, ID de grupo, Nome de usuário (para volumes SMB ou de protocolo duplo) e Permissões.
  6. Clique em Salvar para modificar o bucket existente.

Observação

Não é possível modificar o caminho de um bucket. Para atualizar o caminho de um bucket, exclua e recrie o bucket com o novo caminho.

Gerar credenciais

  1. Navegue até ao bucket recém-criado. Selecione Gerar chaves.
  2. Insira o tempo de vida desejado da chave de acesso em dias e selecione Gerar chaves. Depois de selecionar Gerar chaves, o portal exibe a chave de acesso e a chave de acesso secreta.

    Importante

    A chave de acesso e a chave de acesso secreta são exibidas apenas uma vez. Guarde as chaves de forma segura. Não partilhe as chaves.

  3. Depois de definir as credenciais, você pode gerar uma nova chave de acesso e uma chave de acesso secreta selecionando o ... menu e, em seguida, selecionando Gerar chaves de acesso. A geração de novas chaves invalida imediatamente as chaves existentes.

Excluir um bucket

A exclusão de um bucket é uma operação permanente. Não é possível recuperar o bucket depois de eliminá-lo.

  1. Na sua conta NetApp, navegue até Buckets.
  2. Marque a caixa de seleção ao lado do bucket que você deseja excluir.
  3. Selecione Eliminar.
  4. No modal, selecione Excluir para confirmar que deseja excluir o bucket.

Próximos passos