# Gerenciar políticas de bucket de vetores
<a name="s3-vectors-bucket-policy"></a>

Políticas de bucket de vetores são políticas baseadas em recursos que você anexa diretamente aos buckets de vetores para controlar o acesso ao bucket e ao respectivo conteúdo. É possível adicionar, visualizar, editar e excluir políticas de bucket de vetores usando a API REST do Amazon S3, SDKs da AWS, o console do S3 ou a AWS Command Line Interface (AWS CLI). As políticas de bucket para buckets de vetores podem conceder permissões a entidades principais de outras contas da AWS, o que as torna úteis para cenários de acesso entre contas.

## Operações de gerenciamento de políticas
<a name="policy-management-operations"></a>
+ [PutVectorBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_PutVectorBucketPolicy.html): adicione ou atualize uma política de bucket.
+ [GetVectorBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_GetVectorBucketPolicy.html): recupere a política atual do bucket.
+ [DeleteVectorBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_DeleteVectorBucketPolicy.html): remova a política de bucket.

## Adicionar uma política de bucket de vetores
<a name="vector-bucket-policies-cli"></a>

### Usar o console do S3
<a name="console-procedure"></a>

1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Amazon S3**.

1. Escolha **Buckets de vetores** e selecione o nome do bucket de vetores ao qual você deseja adicionar uma política.

1. Escolha a aba **Permissões**.

1. Em **Política de bucket de vetores**, escolha **Editar**.

1. No editor de políticas, insira a política JSON.

1. (Opcional) Escolha **Exemplos de política** para ver exemplos de política que você pode adaptar às suas necessidades.

1. Depois de inserir a política, escolha **Salvar alterações**.

### Como usar o AWS CLI
<a name="vector-bucket-policy-add-CLI"></a>

Para adicionar ou atualizar uma política de bucket, use o comando de exemplo a seguir e substitua os *espaços reservados para entrada do usuário* por suas próprias informações.

```
aws s3vectors put-vector-bucket-policy \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --policy '{"Version": "2012-10-17",		 	 	 "Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::111122223333:root"},"Action":"s3vectors:*","Resource":"arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket"}]}'
```

## Visualizar uma política de bucket de vetores
<a name="vector-bucket-policy-get"></a>

### Usar o console do S3
<a name="console-procedure"></a>

1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Amazon S3**.

1. Escolha **Buckets de vetores** e selecione o nome do bucket de vetores para o qual você deseja visualizar a política.

1. Escolha a aba **Permissões**.

### Como usar o AWS CLI
<a name="vector-bucket-policy-get-CLI"></a>

Para recuperar uma política de bucket, use o comando de exemplo a seguir e substitua os *espaços reservados para entrada do usuário* por suas próprias informações.

```
aws s3vectors get-vector-bucket-policy \
  --vector-bucket-name "amzn-s3-demo-vector-bucket"
```

## Excluir uma política de bucket de vetores
<a name="vector-bucket-policy-delete"></a>

### Usar o console do S3
<a name="console-procedure"></a>

1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Amazon S3**.

1. Escolha **Buckets de vetores** e selecione o nome do bucket de vetores para o qual você deseja excluir a política.

1. Escolha a aba **Permissões**.

1. Em **Política de buckets de vetores**, escolha **Excluir**.

### Como usar o AWS CLI
<a name="vector-bucket-policy-delete-CLI"></a>

Para excluir uma política de bucket, use o comando de exemplo a seguir e substitua os *espaços reservados para entrada do usuário* por suas próprias informações.

```
aws s3vectors delete-vector-bucket-policy \
  --vector-bucket-name "amzn-s3-demo-vector-bucket"
```

Para obter informações detalhadas sobre como criar e gerenciar políticas de bucket, bem como exemplos de política e práticas recomendadas, consulte [Exemplos de política baseada em recursos do S3 Vectors](s3-vectors-resource-based-policies.md).