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

Quando crei un punto di accesso, Amazon S3 genera automaticamente un alias che puoi utilizzare al posto di un nome bucket Amazon S3 per l'accesso ai dati. Puoi utilizzare questo alias del punto di accesso al posto di un nome della risorsa Amazon (ARN) per qualsiasi operazione del piano dati del punto di accesso. Per un elenco di queste operazioni, consulta Compatibilità dei punti di accesso con i AWS servizi.

Di seguito viene illustrato un esempio di ARN e alias del punto di accesso per un punto di accesso denominato my-access-point.

• ARN: arn:aws:s3:region:account-id:accesspoint/my-access-point

• Alias del punto di accesso: my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias

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

Nomi degli alias del punto di accesso

Un nome alias punto di accesso viene creato nello stesso spazio dei nomi di un bucket Amazon S3. Questo nome alias viene generato automaticamente e non può essere modificato. Un nome alias del punto di accesso soddisfa tutti i requisiti di un nome bucket Amazon S3 valido e comprende le seguenti parti:

access point prefix-metadata-s3alias

Nota

Il suffisso -s3alias è riservato ai nomi alias dei punti di accesso e non può essere utilizzato per i nomi dei bucket o dei punti di accesso. Per ulteriori informazioni sulle regole di denominazione dei bucket Amazon S3, consulta Regole di denominazione dei bucket.

Casi d'uso e limitazioni degli alias dei punti di accesso

Quando si adottano i punti di accesso, è possibile utilizzare nomi alias dei punti di accesso senza richiedere modifiche estese di codice.

Quando crei un punto di accesso, Amazon S3 genera automaticamente un nome alias del punto di accesso, come mostrato nell'esempio seguente. Per eseguire questo comando, sostituire user input placeholders con le proprie informazioni.

aws s3control create-access-point --bucket example-s3-bucket1 --name my-access-point --account-id 111122223333
{
    "AccessPointArn":
    "arn:aws:s3:region:111122223333:accesspoint/my-access-point",
    "Alias": "my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias"
}

Puoi utilizzare questo nome alias del punto di accesso invece di un nome bucket Amazon S3 in qualsiasi operazione del piano dati. Per un elenco di queste operazioni, consulta Compatibilità dei punti di accesso con i AWS servizi.

L' AWS CLI esempio seguente del get-object comando utilizza l'alias del punto di accesso del bucket per restituire informazioni sull'oggetto specificato. Per eseguire questo comando, sostituire user input placeholders con le proprie informazioni.

aws s3api get-object --bucket my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias --key dir/my_data.rtf my_data.rtf
            
{
    "AcceptRanges": "bytes",
    "LastModified": "2020-01-08T22:16:28+00:00",
    "ContentLength": 910,
    "ETag": "\"00751974dc146b76404bb7290f8f51bb\"",
    "VersionId": "null",
    "ContentType": "text/rtf",
    "Metadata": {}
}

Limitazioni

• Gli alias non possono essere configurati dai clienti.

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

• È possibile utilizzare questo nome di alias del punto di accesso al posto di un nome di bucket Amazon S3 in alcune operazioni del piano dati. Per un elenco di queste operazioni, consulta Compatibilità dei punti di accesso con le operazioni S3.

• Non puoi utilizzare un nome alias del punto di accesso per le operazioni del piano di controllo Amazon S3. Per un elenco delle operazioni del piano di controllo Amazon S3, consulta Controllo Amazon S3 nellaDocumentazione di riferimento delle API di Amazon Simple Storage Service.

• Non puoi utilizzare gli alias dei punti di accesso S3 come origine o destinazione per le operazioni Move nella console Amazon S3.

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

• Gli alias non possono essere utilizzati come destinazione di registrazione per i log di accesso al server S3.

• Gli alias non possono essere utilizzati come destinazione di registrazione per i log. AWS CloudTrail

• Amazon SageMaker GroundTruth non supporta gli alias dei punti di accesso.