

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

# Gestione dell’ambito dei punti di accesso per bucket di directory
<a name="access-points-directory-buckets-manage-scope"></a>

Questa sezione spiega come visualizzare e modificare l'ambito dei punti di accesso per i bucket di directory utilizzando l' AWS Command Line Interface API REST o AWS SDKs. È possibile utilizzare l’ambito del punto di accesso per limitare l’accesso a prefissi od operazioni API specifici.

**Topics**
+ [Visualizzazione dell’ambito dei punti di accesso per bucket di directory](#access-points-directory-buckets-view-scope)
+ [Modifica dell’ambito del punto di accesso per bucket di directory](#access-points-directory-buckets-modify-scope)
+ [Eliminazione dell’ambito dei punti di accesso per bucket di directory](#access-points-directory-buckets-delete-scope)

## Visualizzazione dell’ambito dei punti di accesso per bucket di directory
<a name="access-points-directory-buckets-view-scope"></a>

Puoi utilizzare l'API Console di gestione AWS, AWS Command Line Interface, REST o AWS SDKs visualizzare l'ambito del tuo punto di accesso per i bucket di directory.

### Utilizzo della console S3
<a name="access-points-directory-buckets-view-scope-console"></a>

**Come visualizzare l’ambito del punto di accesso per bucket di directory**

1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nella barra di navigazione nella parte superiore della pagina, scegli il nome del file attualmente visualizzato Regione AWS. Quindi, scegli la Regione per la quale si desidera elencare i punti di accesso. 

1. Nel riquadro di navigazione a sinistra della console scegli **Punti di accesso per bucket di directory**.

1. (Facoltativo) Cerca i punti di accesso per nome. Qui Regione AWS verranno visualizzati solo i punti di accesso selezionati.

1. Scegli il nome del punto di accesso da gestire.

1. Scegli la scheda **Autorizzazioni**.

1. In **Ambito del punto di accesso** potrai vedere i prefissi e le autorizzazioni applicati al punto di accesso.

### Utilizzando il AWS CLI
<a name="access-points-directory-buckets-view-scope-cli"></a>

Il comando di `get-access-point-scope` esempio seguente mostra come è possibile utilizzare AWS CLI per visualizzare l'ambito del punto di accesso.

Il comando seguente mostra l'ambito del punto di accesso {{{{my-access-point}}}} -- {{zoneID}} --xa-s3 for. Account AWS {{111122223333}}

```
aws s3control get-access-point-scope --name {{{{my-access-point}}}}--{{zoneID}}--xa-s3 --account-id {{111122223333}}      
```

Per ulteriori informazioni ed esempi, vedere [get-access-point-scope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/get-access-point-scope.html)nel Command Reference. AWS CLI 

**Example risultato di `get-access-point-scope`**  

```
{
    "Scope": {
        "Permissions": [
            "ListBucket",
            "PutObject"
        ]
  "Prefixes": [
            "Prefix": "MyPrefix1*",
            "Prefix": "MyObjectName.csv"
        ]
    }
}
```

### Utilizzo della REST API
<a name="access-points-directory-buckets-view-scope-rest-api"></a>

La richiesta di esempio `GetAccessPointScope` seguente mostra come utilizzare la REST API per visualizzare l’ambito del punto di accesso.

La seguente richiesta mostra l'ambito del punto di accesso {{{{my-access-point}}}} -- {{region}} - {{zoneID}} --xa-s3 per. Account AWS {{111122223333}}

```
GET /v20180820/accesspoint/{{{{my-access-point}}}}--{{zoneID}}--xa-s3/scope HTTP/1.1 
Host: s3express-control.{{region}}.amazonaws.com 
x-amz-account-id: {{111122223333}}
```

**Example risultato di `GetAccessPointScope`**  

```
      HTTP/1.1 200
      <?xml version="1.0" encoding="UTF-8"?>
      <GetAccessPointScopeResult>    
          <Scope>            
              <Prefixes>                
                  <Prefix>MyPrefix1*</Prefix>
                  <Prefix>MyObjectName.csv</Prefix>
              </Prefixes>            
              <Permissions>                 
                  <Permission>ListBucket</Permission>                 
                  <Permission>PutObject</Permission>
              </Permissions>     
              <Scope>
      </GetAccessPointScopeResult>
```

### Usando il AWS SDKs
<a name="access-points-directory-buckets-view-scope-sdk"></a>

È possibile utilizzare il AWS SDKs per visualizzare l'ambito del punto di accesso. Per ulteriori informazioni, consulta l'[elenco dei supporti SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessPointScope.html#API_control_GetAccessPointScope_SeeAlso) nel riferimento alle API di Amazon Simple Storage Service.

## Modifica dell’ambito del punto di accesso per bucket di directory
<a name="access-points-directory-buckets-modify-scope"></a>

Puoi utilizzare l'API Console di gestione AWS, AWS Command Line Interface, REST o AWS SDKs modificare l'ambito dei tuoi punti di accesso per i bucket di directory. L’ambito del punto di accesso viene utilizzato per limitare l’accesso a prefissi od operazioni API specifici oppure una combinazione di entrambi.

Puoi includere una o più delle seguenti operazioni API come autorizzazioni:
+ `PutObject`
+ `GetObject`
+ `DeleteObject`
+ `ListBucket` (richiesto per `ListObjectsV2`)
+ `GetObjectAttributes`
+ `AbortMultipartUploads`
+ `ListBucketMultipartUploads`
+ `ListMultipartUploadParts`

**Nota**  
È possibile specificare qualsiasi numero di prefissi, ma la lunghezza totale dei caratteri di tutti i prefissi deve essere inferiore a 256 byte.

### Utilizzo della console S3
<a name="access-points-directory-buckets-modify-scope-console"></a>

**Come modificare l’ambito del punto di accesso**

1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nella barra di navigazione nella parte superiore della pagina, scegli il nome del file attualmente visualizzato Regione AWS. Quindi, scegli la Regione per la quale si desidera elencare i punti di accesso. 

1. Nel riquadro di navigazione a sinistra della console scegli **Punti di accesso per bucket di directory**.

1. (Facoltativo) Cerca i punti di accesso per nome. Qui Regione AWS verranno visualizzati solo i punti di accesso selezionati.

1. Scegli il nome del punto di accesso da gestire.

1. Scegli la scheda **Autorizzazioni**.

1. Scegli **Modifica** nella sezione **Ambito del punto di accesso**.

1. Per aggiungere o rimuovere prefissi:

   1. Per aggiungere un prefisso, scegli **Aggiungi prefisso**. Nel campo **Prefisso**, inserisci il prefisso del bucket di directory. Ripeti l’operazione per aggiungere altri prefissi.

   1. Per rimuovere un prefisso, scegli **Rimuovi**.

1. Per aggiungere o rimuovere autorizzazioni:

   1. Per aggiungere un’autorizzazione, scegli l’autorizzazione nel campo **Scegli le operazioni sui dati**.

   1. Per rimuovere un’autorizzazione, scegli la **X** accanto all’autorizzazione.

1. Scegli **Save changes** (Salva modifiche).

### Utilizzando il AWS CLI
<a name="access-points-directory-buckets-modify-scope-cli"></a>

Il comando di `put-access-point-scope` esempio seguente mostra come utilizzare AWS CLI per modificare l'ambito del punto di accesso.

Il comando seguente modifica l'ambito del punto di accesso di {{{{my-access-point}}}} -- {{zoneID}} --xa-s3 per. Account AWS {{111122223333}}

**Nota**  
È possibile utilizzare i caratteri jolly nei prefissi utilizzando il carattere asterisco (\*). Per utilizzare il carattere asterisco come valore letterale, si aggiunge una barra rovesciata (\\) prima dell’asterisco per eseguirne l’escape.  
Tutti i prefissi terminano implicitamente con '\*', il che significa che vengono inclusi tutti i percorsi all’interno del prefisso.  
Quando si modifica l'ambito di un punto di accesso con AWS CLI, si sostituisce l'ambito esistente.

```
aws s3control put-access-point-scope --name {{{{my-access-point}}}}--{{zoneID}}--xa-s3 --account-id {{111122223333}} --scope Prefixes={{string}},Permissions={{string}}
```

Per ulteriori informazioni ed esempi, vedere [put-access-point-scope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/put-access-point-scope.html)nel AWS CLI Command Reference.

### Utilizzo della REST API
<a name="access-points-directory-buckets-modify-scope-rest-api"></a>

La richiesta di esempio `PutAccessPointScope` seguente mostra come utilizzare la REST API per modificare l’ambito del punto di accesso.

La seguente richiesta modifica l'ambito del punto di accesso di {{{{my-access-point}}}} -- {{zoneID}} --xa-s3 per. Account AWS {{111122223333}}

**Nota**  
È possibile utilizzare i caratteri jolly nei prefissi utilizzando il carattere asterisco (\*). Per utilizzare il carattere asterisco come valore letterale, si aggiunge una barra rovesciata (\\) prima dell’asterisco per eseguirne l’escape.  
Tutti i prefissi terminano implicitamente con '\*', il che significa che vengono inclusi tutti i percorsi all’interno del prefisso.  
Quando si modifica l’ambito di un punto di accesso con l’API, si sostituisce l’ambito esistente.

```
PUT /v20180820/accesspoint/{{{{my-access-point}}}}--{{zoneID}}--xa-s3/scope HTTP/1.1 
Host: s3express-control.{{region}}.amazonaws.com 
x-amz-account-id: {{111122223333}}
<?xml version="1.0" encoding="UTF-8"?>
<PutAccessPointScopeRequest>   
        <Scope>        
            <Prefixes>        
                <Prefix>Jane/*</Prefix>              
            </Prefixes>       
            <Permissions>        
                <Permission>PutObject</Permission>
                <Permission>GetObject</Permission>
            </Permissions>   
            <Scope>
    </PutAccessPointScopeRequest>
```

### Usando il AWS SDKs
<a name="access-points-directory-buckets-modify-scope-sdk"></a>

Puoi utilizzare l'API AWS CLI AWS SDKs, o REST per modificare l'ambito del tuo punto di accesso. Per ulteriori informazioni, consulta l'[elenco dei supporti SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutAccessPointScope.html#API_control_PutAccessPointScope_SeeAlso) nel riferimento alle API di Amazon Simple Storage Service.

## Eliminazione dell’ambito dei punti di accesso per bucket di directory
<a name="access-points-directory-buckets-delete-scope"></a>

Puoi utilizzare l'API Console di gestione AWS, AWS Command Line Interface, REST o AWS SDKs eliminare l'ambito dei tuoi punti di accesso per i bucket di directory.

**Nota**  
Quando si elimina l’ambito di un punto di accesso, vengono eliminati tutti i prefissi e le autorizzazioni.

### Utilizzo della console S3
<a name="access-points-directory-buckets-delete-scope-console"></a>

**Come eliminare l’ambito del punto di accesso**

1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nella barra di navigazione nella parte superiore della pagina, scegli il nome del file attualmente visualizzato Regione AWS. Quindi, scegli la Regione per la quale si desidera elencare i punti di accesso. 

1. Nel riquadro di navigazione a sinistra della console scegli **Punti di accesso per bucket di directory**.

1. (Facoltativo) Cerca i punti di accesso per nome. Qui Regione AWS verranno visualizzati solo i punti di accesso selezionati.

1. Scegli il nome del punto di accesso da gestire.

1. Scegli la scheda **Autorizzazioni**.

1. In **Ambito del punto di accesso**, scegli **Elimina**.

1. Nel campo **Per confermare l’eliminazione, digita "confirm"**, inserisci **confirm**.

1. Scegli **Elimina**.

### Utilizzando il AWS CLI
<a name="access-points-directory-buckets-delete-scope-cli"></a>

Il comando di `delete-access-point-scope` esempio seguente mostra come utilizzare AWS CLI per eliminare l'ambito del punto di accesso.

Il comando seguente elimina l'ambito del punto di accesso {{{{my-access-point}}}} -- {{zoneID}} --xa-s3 for. Account AWS {{111122223333}}

```
aws s3control delete-access-point-scope --name {{{{my-access-point}}}}--{{region}}-{{zoneID}}--xa-s3 --account-id {{111122223333}}
```

Per ulteriori informazioni ed esempi, vedere [delete-access-point-scope](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/delete-access-point-scope.html)nel Command Reference. AWS CLI 

### Utilizzo della REST API
<a name="access-points-directory-buckets-delete-scope-rest-api"></a>

La seguente richiesta elimina l'ambito del punto di accesso {{{{my-access-point}}}} -- {{zoneID}} --xa-s3 for. Account AWS {{111122223333}}

```
DELETE /v20180820/accesspoint/{{{{my-access-point}}}}--{{zoneID}}--xa-s3/scope HTTP/1.1 
Host: s3express-control.{{region}}.amazonaws.com 
x-amz-account-id: {{111122223333}}
```

### Usando il AWS SDKs
<a name="access-points-directory-buckets-delete-scope-sdk"></a>

È possibile utilizzare il AWS SDKs per eliminare l'ambito del punto di accesso. Per ulteriori informazioni, consulta l'[elenco dei supporti SDKs](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DeleteAccessPointScope.html#API_control_DeleteAccessPointScope_SeeAlso) nel riferimento alle API di Amazon Simple Storage Service.