Riferimento ai punti di accesso con ARNs alias dei punti di accesso o in stile ospitato virtualmente URIs - Amazon Simple Storage Service
Punto di accesso ARNsAlias del punto di accessoURI in stile ospitato virtualmente

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à.

Riferimento ai punti di accesso con ARNs alias dei punti di accesso o in stile ospitato virtualmente URIs

Dopo aver creato un punto di accesso, è possibile utilizzare questi endpoint per eseguire una serie di operazioni. Quando fai riferimento a un punto di accesso, puoi utilizzare Amazon Resource Names (ARNs), l'alias del punto di accesso o l'URI in stile hosting virtuale.

Punto di accesso ARNs

I punti di accesso hanno Amazon Resource Names (ARNs). ARNs I punti di accesso sono simili ai bucket ARNs, ma vengono digitati e codificati in modo esplicito il punto di accesso Regione AWS e l' Account AWS ID del proprietario del punto di accesso. Per ulteriori informazioni su ARNs, consulta Amazon Resource Names (ARNs) nel Riferimenti generali di AWS.

L'access point ARNs utilizza il seguente formato:

arn:aws:s3:region:account-id:accesspoint/resource

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test rappresenta il punto di accesso denominato test, di proprietà dell'account 123456789012 nella Regione us-west-2.

  • arn:aws:s3:us-west-2:123456789012:accesspoint/* rappresenta tutti i punti di accesso nell'account 123456789012 nella Regione us-west-2.

ARNs per gli oggetti a cui si accede tramite un punto di accesso, utilizzare il seguente formato:

arn:aws:s3:region:account-id:accesspoint/access-point-name/object/resource

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/unit-01 rappresenta l'oggetto unit-01, a cui si accede attraverso il punto di accesso denominato test, posseduto dall'account 123456789012 nella Regione us-west-2.

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/* rappresenta tutti gli oggetti per il punto di accesso denominato test nell'account 123456789012 nella Regione us-west-2.

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/unit-01/finance/* rappresenta tutti gli oggetti sotto il prefisso unit-01/finance/ per il punto di accesso denominato test nell'account 123456789012 nella Regione us-west-2.

Alias del punto di accesso

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à con i punti 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 per uso generico.

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 amzn-s3-demo-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à con i punti di accesso.

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 degli alias dei punti di accesso

  • 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 è possibile utilizzare gli alias dei punti di accesso S3 come origine o destinazione per le operazioni di spostamento 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.

URI in stile ospitato virtualmente

I punti di accesso supportano solo l'indirizzamento. virtual-host-style In un URI in stile host virtuale, il nome del punto di accesso Regione AWS fa parte del nome di dominio contenuto nell'URL. Account AWS Per ulteriori informazioni sull'hosting virtuale, consulta. Hosting virtuale dei bucket

Gli URI in stile hosting virtuale per i punti di accesso utilizzano il seguente formato:

https://access-point-name-account-id.s3-accesspoint.region.amazonaws.com
Nota

  • Se il nome del punto di accesso include trattini (-), includere i trattini nell'URL e inserire un altro trattino prima dell'ID account. Ad esempio, per utilizzare un punto di accesso denominato finance-docs di proprietà dell'account 123456789012 nella Regione us-west-2, l'URL appropriato è https://finance-docs-123456789012.s3-accesspoint.us-west-2.amazonaws.com.

  • I punti di accesso S3 non supportano l'accesso tramite HTTP. I punti di accesso supportano solo l'accesso sicuro tramite HTTPS.