Você pode criar um ponto de acesso para qualquer bucket de diretório com a AWS CLI, a API REST ou os SDKs da AWS. Cada ponto de acesso é associado a um único bucket de diretório, e você pode criar centenas de pontos de acesso por bucket. Ao criar um ponto de acesso, você escolhe o nome do ponto de acesso e o bucket de diretório ao qual associá-lo. O nome do ponto de acesso consiste em um nome base que você fornece e um sufixo que inclui o ID da zona local dedicada (DLZ) da AWS do local do bucket seguido de --xa-s3. Por exemplo, .myaccesspoint-zoneid--xa-s3
Ao criar um ponto de acesso, você também pode restringir o acesso ao ponto de acesso por meio de uma nuvem privada virtual (VPC). Em seguida, você pode começar imediatamente a ler e gravar dados por meio do ponto de acesso usando o respectivo nome, assim como você usa o nome de um bucket de diretório.
Depois de criar o ponto de acesso, você pode configurar a política de recursos do IAM do ponto de acesso e usar o escopo do ponto de acesso para restringir o acesso a prefixos ou operações de API específicos ou uma combinação de ambos. Para obter mais informações, consulte Gerenciar pontos de acesso para buckets de diretório.
O exemplo de comando a seguir cria um ponto de acesso chamado example-ap para o bucket amzn-s3-demo-bucket-usw2-az1--x-s3 na conta 111122223333. Para criar o ponto de acesso para um bucket de diretório, envie uma solicitação ao Amazon S3 que especifica o seguinte:
-
O nome do ponto de acesso, que consiste em um nome base que você fornece e um sufixo que inclui o ZoneID (zona de disponibilidade da AWS) do local do bucket seguido de
--xa-s3. Para obter informações sobre regras de nomeação, consulte Referência a pontos de acesso para buckets de diretório. -
O nome do bucket ao qual você deseja associar o ponto de acesso.
-
O ID da conta da AWS à qual o ponto de acesso pertence.
aws s3control create-access-point --name example-ap--usw2-az1--xa-s3 --account-id 111122223333 --bucket amzn-s3-demo-bucket--usw2-az2--x-s3Ao criar um ponto de acesso para um bucket entre contas, inclua o parâmetro --bucket-account-id. O exemplo de comando a seguir cria um ponto de acesso na Conta da AWS 111122223333 para o bucket amzn-s3-demo-bucket2--usw2-az1--x-s3, que pertence à Conta da AWS 444455556666.
aws s3control create-access-point --name example-ap--usw2-az1--xa-s3 --account-id 111122223333 --bucket amzn-s3-demo-bucket--usw2-az1--x-s3 --bucket-account-id 444455556666Depois de criar o ponto de acesso, modifique-o para adicionar um escopo e uma política, se necessário. Para obter mais informações, consulte Gerenciar pontos de acesso para buckets de diretório.
O exemplo de comando a seguir cria um ponto de acesso chamado example-ap para o bucket amzn-s3-demo-bucket-usw2-az1--x-s3 na conta 111122223333. Para criar o ponto de acesso para um bucket de diretório, envie uma solicitação ao Amazon S3 que especifica o seguinte:
-
O nome do ponto de acesso. Para obter informações sobre regras de nomeação, consulte Referência a pontos de acesso para buckets de diretório.
-
O nome do bucket ao qual você deseja associar o ponto de acesso.
-
A Conta da AWS à qual o ponto de acesso pertence.
PUT /v20180820/accesspoint/example-ap--usw2-az1--xa-s3 HTTP/1.1
Host: s3express-control.us-west-2.amazonaws.com
x-amz-account-id: 111122223333
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointRequest>
<Bucket>amzn-s3-demo-bucket--usw2-az1--x-s3</Bucket>
<BucketAccountId>111122223333</BucketAccountId>
</CreateAccessPointRequest>
Resposta:
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointResult>
<AccessPointArn>
"arn:aws:s3express:us-west-2:111122223333:accesspoint/example-ap--usw2-az1--xa-s3"
</AccessPointArn>
<Alias>example-ap--usw2-az1--xa-s3</Alias>
</CreateAccessPointResult>
Depois de criar o ponto de acesso, modifique-o para adicionar um escopo e uma política, se necessário. Para obter mais informações, consulte Gerenciar pontos de acesso para buckets de diretório.
Você pode usar os SDKs da AWS para criar um ponto de acesso. Para obter mais informações, consulte a lista de SDKs compatíveis na “Referência de API do Amazon Simple Storage Service”.
