Uso de un alias de estilo de bucket para su punto de acceso de bucket de S3 en Outposts

Con S3 en Outposts, debe utilizar puntos de acceso para acceder a cualquier objeto de un bucket de Outposts. Cada vez que se crea un punto de acceso para un bucket, S3 en Outposts genera de forma automática un alias de punto de acceso. Puede utilizar este alias de punto de acceso en lugar de un ARN de punto de acceso para cualquier operación del plano de datos. Por ejemplo, puede usar un alias de punto de acceso para realizar operaciones a nivel de objeto, como PUT, GET, LIST y más. Para obtener una lista de las operaciones, consulte Operaciones de la API de Amazon S3 para administrar objetos.

Los siguientes ejemplos muestran un ARN y un alias de punto de acceso para un punto de acceso llamado my-access-point.

• ARN del punto de acceso: arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/my-access-point

• Alias de punto de acceso: my-access-po-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3

Para obtener más información acerca de los ARN, consulte Nombres de recurso de Amazon (ARN) en la Referencia general de AWS.

Para obtener más información acerca de los alias de punto de acceso, consulte los siguientes temas.

Alias de punto de acceso

Se crea un alias de punto de acceso en el mismo espacio de nombres que un bucket de Outposts. Al crear un punto de acceso, S3 en Outposts genera de forma automática un alias de punto de acceso que no se puede modificar. Un alias de punto de acceso cumple con todos los requisitos de un nombre de bucket válido de S3 en Outposts y consta de las siguientes partes:

access point name prefix-metadata--op-s3

nota

El sufijo --op-s3 está reservado para los alias de punto de acceso, por lo que se recomienda no utilizarlo para los nombres de punto de acceso o bucket. Para obtener más información acerca de las reglas de nomenclatura del bucket de S3 en Outposts, consulte Trabajo con buckets de S3 en Outposts.

Búsqueda del alias de punto de acceso

En los siguientes ejemplos se muestra cómo encontrar un alias de punto de acceso utilizando la consola de Amazon S3 y la AWS CLI.

ejemplo : Buscar y copiar un alias de punto de acceso en la consola de Amazon S3

Después de crear un punto de acceso en la consola, puede obtener el alias del punto de acceso en la columna Access Point alias (Alias de puntos de acceso) de la lista Access Points (Puntos de acceso).

Para copiar un alias de punto de acceso

1. Abra la consola de Amazon S3 en https://console.aws.amazon.com/s3.

2. En el panel de navegación de la izquierda, elija Outposts access points (Puntos de acceso de Outposts).

3. Para copiar el alias de punto de acceso, realice una de las siguientes acciones:

   • En la lista Access Points (Puntos de acceso), seleccione el botón de opción situado junto al nombre del punto de acceso y, a continuación, elija Copy Access Point alias (Copiar alias de punto de acceso).

   • Seleccione el nombre del punto de acceso. A continuación, en Outposts access point overview (Descripción general del punto de acceso de Outposts), copie el alias del punto de acceso.

ejemplo : Crear un punto de acceso utilizando la AWS CLI y buscar el alias del punto de acceso en la respuesta

El siguiente ejemplo de la AWS CLI del comando create-access-point crea el punto de acceso y devuelve el alias de punto de acceso generado automáticamente. Para ejecutar este comando, sustituya los user input placeholders con su propia información.

aws s3control create-access-point --bucket example-outposts-bucket --name example-outposts-access-point --account-id 123456789012

{
    "AccessPointArn":
    "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point",
    "Alias": "example-outp-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3"
}

ejemplo : Obtener un alias de punto de acceso utilizando la AWS CLI

El siguiente ejemplo de AWS CLI del comando get-access-point devuelve información sobre el punto de acceso especificado. Esta información incluye el alias de punto de acceso. Para ejecutar este comando, sustituya los user input placeholders con su propia información.

aws s3control get-access-point --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket --name example-outposts-access-point --account-id 123456789012

{
    "Name": "example-outposts-access-point",
    "Bucket": "example-outposts-bucket",
    "NetworkOrigin": "Vpc",
    "VpcConfiguration": {
        "VpcId": "vpc-01234567890abcdef"
    },
    "PublicAccessBlockConfiguration": {
        "BlockPublicAcls": true,
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "RestrictPublicBuckets": true
    },
    "CreationDate": "2022-09-18T17:49:15.584000+00:00",
    "Alias": "example-outp-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3"
}

ejemplo : Enumerar los puntos de acceso para encontrar un alias de punto de acceso mediante la AWS CLI

El siguiente ejemplo de AWS CLI del comando list-access-points enumera información sobre el punto de acceso especificado. Esta información incluye el alias de punto de acceso. Para ejecutar este comando, sustituya los user input placeholders con su propia información.

aws s3control list-access-points --account-id 123456789012 --bucket arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket

{
    "AccessPointList": [
        {
            "Name": "example-outposts-access-point",
            "NetworkOrigin": "Vpc",
            "VpcConfiguration": {
                "VpcId": "vpc-01234567890abcdef"
            },
            "Bucket": "example-outposts-bucket",
            "AccessPointArn": "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/accesspoint/example-outposts-access-point",
            "Alias": "example-outp-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3"
        }
    ]
}

Uso de un alias de punto de acceso en una operación de objeto de S3 en Outposts

Al adoptar puntos de acceso, puede utilizar alias de puntos de acceso sin tener que hacer cambios exhaustivos en el código.

En este ejemplo de AWS CLI se muestra una operación get-object para un bucket de S3 en Outposts. En este ejemplo, se utiliza el alias del punto de acceso como el valor de --bucket, en lugar del ARN completo del punto de acceso.

aws s3api get-object --bucket my-access-po-o0b1d075431d83bebde8xz5w8ijx1qzlbp3i3kuse10--op-s3 --key  testkey  sample-object.rtf

{
    "AcceptRanges": "bytes",
    "LastModified": "2020-01-08T22:16:28+00:00",
    "ContentLength": 910,
    "ETag": "\"00751974dc146b76404bb7290f8f51bb\"",
    "VersionId": "null",
    "ContentType": "text/rtf",
    "Metadata": {}
}

Limitaciones

• Los clientes no pueden configurar los alias.

• Los alias no se pueden eliminar, modificar ni dehabillitar en un punto de acceso.

• No puede utilizar un alias de punto de acceso para operaciones de plano de control de S3 en Outposts. Para ver la lista de operaciones del plano de control de S3 en Outposts, consulte Operaciones de la API de Amazon S3 Control para administrar buckets.

• Los alias no se pueden usar en las políticas de AWS Identity and Access Management (IAM).