Utilizzo di un alias in stile bucket per il punto di accesso del bucket S3 su Outposts

Con S3 su Outposts devi utilizzare i punti di accesso per accedere a qualsiasi oggetto in un bucket Outposts. Ogni volta che crei un punto di accesso per un bucket, S3 su Outposts genera automaticamente un alias per tale punto di accesso. Puoi utilizzare questo alias del punto di accesso al posto dell'ARN del punto di accesso per qualsiasi operazione del piano dati. Ad esempio, è possibile utilizzare un alias del punto di accesso per eseguire operazioni a livello di oggetto come PUT, GET, LIST e altre ancora. Per un elenco di queste operazioni, consulta Operazioni API Amazon S3 per la gestione degli oggetti.

Negli esempi seguenti viene illustrato un ARN e un alias per un punto di accesso denominato my-access-point.

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

• Alias del punto di accesso - my-access-po-o01ac5d28a6a232904e8xz5w8ijx1qzlbp3i3kuse10--op-s3

Per ulteriori informazioni sull'utilizzo degli ARN, consulta Amazon Resource Name (ARN) nella Riferimenti generali di AWS.

Per ulteriori informazioni sugli alias del punto di accesso, consulta gli argomenti indicati di seguito.

Alias del punto di accesso

Un alias del punto di accesso viene creato nello stesso spazio dei nomi del bucket S3 su Outposts. Quando crei un punto di accesso, S3 su Outposts genera automaticamente un alias per tale punto di accesso che non può essere modificato. Un alias del punto di accesso soddisfa tutti i requisiti di un nome di bucket S3 su Outposts valido e comprende le seguenti parti:

access point name prefix-metadata--op-s3

Nota

Il suffisso --op-s3 è riservato agli alias del punto di accesso; ti consigliamo di non utilizzarlo per i nomi dei bucket o dei punti di accesso. Per ulteriori informazioni sulle regole di denominazione dei bucket S3 su Outposts, consulta Utilizzo di bucket S3 su Outposts.

Ricerca dell'alias del punto di accesso

Negli esempi seguenti viene illustrato come trovare un alias del punto di accesso utilizzando la console Amazon S3 e AWS CLI.

Esempio - Ricerca e copia dell'alias del punto di accesso nella console Amazon S3

Dopo aver creato un punto di accesso nella console, puoi recuperarne l'alias nella colonna Access Point alias (Alias del punto di accesso) nell'elenco Access Points (Punti di accesso).

Copia dell'alias del punto di accesso

1. Apri la console Amazon S3 su https://console.aws.amazon.com/s3/.

2. Nel riquadro di navigazione a sinistra, seleziona Outposts access points (Punti di accesso Outposts).

3. Per copiare l'alias del punto di accesso, effettua una delle seguenti operazioni:

   • Nell'elenco Access Points (Punti di accesso), seleziona il pulsante di opzione accanto al nome del punto di accesso, quindi scegli Copy Access Point alias (Copia alias del punto di accesso).

   • Scegliere il nome del punto di accesso. Quindi, in Outposts access point overview (Panoramica dei punti di accesso Outposts), copia l'alias del punto di accesso.

Esempio - Creazione di un punto di accesso utilizzando la AWS CLI e ricerca dell'alias del punto di accesso nella risposta

Il seguente esempio del comando create-access-point nella AWS CLI crea il punto di accesso e restituisce l'alias del punto di accesso generato automaticamente. Per eseguire questo comando, sostituire user input placeholders con le proprie informazioni.

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"
}

Esempio - Recupero di un alias del punto di accesso utilizzando la AWS CLI

L'esempio AWS CLI seguente del comando get-access-point restituisce le informazioni sul punto di accesso specificato. Queste informazioni includono l'alias del punto di accesso. Per eseguire questo comando, sostituire user input placeholders con le proprie informazioni.

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"
}

Esempio - Elenco dei punti di accesso per trovare un alias del punto di accesso utilizzando la AWS CLI

Il seguente esempio del comando list-access-points nella AWS CLI elenca le informazioni sul punto di accesso specificato. Queste informazioni includono l'alias del punto di accesso. Per eseguire questo comando, sostituire user input placeholders con le proprie informazioni.

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"
        }
    ]
}

Utilizzo di un alias del punto di accesso in un'operazione di oggetto S3 su Outposts

Quando si adottano i punti di accesso, è possibile utilizzare l'alias del punto di accesso senza richiedere importanti modifiche di codice.

Questo esempio nella AWS CLI mostra un'operazione get-object per un bucket S3 su Outposts. Questo esempio utilizza l'alias del punto di accesso come valore per --bucket anziché l'ARN completo del punto di accesso.

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": {}
}

Restrizioni

• Gli alias non possono essere configurati dai clienti.

• Gli alias non possono essere eliminati, modificati o disabilitati in un punto di accesso.

• Non puoi utilizzare un alias del punto di accesso per le operazioni del piano di controllo (control-plane) S3 su Outposts. Per l'elenco delle operazioni del piano di controllo (control-plane) S3 su Outposts, consulta Operazioni API Amazon S3 Control per la gestione dei bucket.

• Gli alias non possono essere utilizzati nelle policy AWS Identity and Access Management (IAM).