Utilizzo di un alias in stile bucket per il punto di accesso del bucket S3 su Outposts - Amazon S3 su Outposts
Alias del punto di accessoUtilizzo di un alias del punto di accesso in un'operazione di oggetto S3 su OutpostsRestrizioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 anziché un punto di accesso per qualsiasi operazione sul piano dati. ARN Ad esempio, è possibile utilizzare un alias del punto di accesso per eseguire operazioni a livello di oggetto comePUT,GET, LIST e altro. Per un elenco di queste operazioni, consulta Operazioni di Amazon S3 per la API gestione degli oggetti.

Gli esempi seguenti mostrano un alias del punto di accesso ARN e per un punto di accesso denominato. my-access-point

  • Punto ARN 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 suARNs, consulta Amazon Resource Names (ARNs) nel 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 all'indirizzo. 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 : crea un punto di accesso utilizzando AWS CLI e trova l'alias del punto di accesso nella risposta

L' AWS CLI esempio seguente del create-access-point comando 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 : ottieni un alias del punto di accesso utilizzando il AWS CLI

L' AWS CLI esempio seguente del get-access-point comando restituisce 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 : Elenca i punti di accesso per trovare un alias del punto di accesso utilizzando il AWS CLI

L' AWS CLI esempio seguente del list-access-points comando 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 AWS CLI esempio mostra un'get-objectoperazione per un bucket S3 on Outposts. Questo esempio utilizza l'alias del punto di accesso come valore per --bucket anziché il punto di accesso completo. ARN

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 Amazon S3 Control: API operazioni per la gestione dei bucket.

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