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à. # CreateAccessPoint Crea un punto di accesso EFS. Un punto di accesso è una visualizzazione specifica dell'applicazione in un file system EFS che applica un utente e un gruppo del sistema operativo e un percorso del file system a qualsiasi richiesta del file system effettuata tramite il punto di accesso. L'utente e il gruppo per sistema operativo del punto di accesso sostituiscono le informazioni di identità fornite dal client NFS. Il percorso file system viene esposto come la directory root del punto di accesso. Le applicazioni che utilizzano il punto di accesso possono accedere ai dati solo nella propria directory e sotto a questa. Un file system può avere un massimo di 10.000 punti di accesso a meno che non si richieda un aumento. Per ulteriori informazioni, vedi [Montaggio di un file system utilizzando i punti di accesso EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html). **Nota** Se più richieste di creazione di punti di accesso sullo stesso file system vengono inviate in rapida successione e il file system è vicino al limite dei punti di accesso, è possibile che si verifichi una limitazione della risposta a tali richieste. Ciò serve a garantire che il file system non superi il limite di punti di accesso dichiarato. Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:CreateAccessPoint`. I punti di accesso possono essere etichettati al momento della creazione. Se i tag vengono specificati nell'azione di creazione delle risorse, IAM esegue autorizzazioni aggiuntive per l'azione `elasticfilesystem:TagResource` per verificare se gli utenti dispongono delle autorizzazioni per creare tag. Pertanto, devi concedere le autorizzazioni esplicite per utilizzare l'operazione `elasticfilesystem:TagResource`. Per ulteriori informazioni, consulta [Concessione dell'autorizzazione all'assegnazione di tag per le risorse durante la creazione](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html). ## Sintassi della richiesta ``` POST /2015-02-01/access-points HTTP/1.1 Content-type: application/json { "ClientToken": "string", "FileSystemId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [ClientToken](#API_CreateAccessPoint_RequestSyntax) ** Una stringa composta da un massimo di 64 caratteri ASCII che Amazon EFS utilizza per garantire una creazione idempotente. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `.+` Obbligatorio: sì ** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) ** ID del file system EFS a cui si applica il punto di accesso. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` Obbligatorio: sì ** [PosixUser](#API_CreateAccessPoint_RequestSyntax) ** L'utente e il gruppo del sistema operativo applicati a tutte le richieste di file system effettuate utilizzando il punto di accesso. Tipo: oggetto [PosixUser](API_PosixUser.md) Obbligatorio: no ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) ** Specifica la directory del file system EFS da esporre come directory principale ai client NFS utilizzando il punto di accesso per accedere al file system EFS. I client che utilizzano il punto di accesso possono accedere solo alla directory principale e sotto a questa. Se `RootDirectory` > `Path` specificato non esiste, Amazon EFS crea la directory principale utilizzando le impostazioni `CreationInfo` quando un client si connette a un punto di accesso. Quando si specifica `RootDirectory`, è necessario fornire `Path` e `CreationInfo`. Amazon EFS crea una directory principale solo se hai fornito CreationInfo: OwnUid, ownGid e le autorizzazioni per la directory. Se non fornisci queste informazioni, Amazon EFS non crea la directory principale. Se la directory principale non esiste, i tentativi di montaggio utilizzando il punto di accesso avranno esito negativo. Tipo: oggetto [RootDirectory](API_RootDirectory.md) Obbligatorio: no ** [Tags](#API_CreateAccessPoint_RequestSyntax) ** Crea tag associati al punto di accesso. Ciascun tag è una coppia chiave-valore e ogni chiave deve essere univoca. *Per ulteriori informazioni, consulta [Tagging AWS resources](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) nella General Reference Guide. AWS * Tipo: matrice di oggetti [Tag](API_Tag.md) Obbligatorio: no ## Sintassi della risposta ``` HTTP/1.1 200 Content-type: application/json { "AccessPointArn": "string", "AccessPointId": "string", "ClientToken": "string", "FileSystemId": "string", "LifeCycleState": "string", "Name": "string", "OwnerId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) ** Il nome della risorsa Amazon (ARN) associato al punto di accesso. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$` ** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) ** L'ID del punto di accesso, assegnato da Amazon EFS. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) ** La stringa opaca specificata nella richiesta per garantire la creazione idempotent. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `.+` ** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) ** ID del file system EFS a cui si applica il punto di accesso. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) ** Identifica la fase del ciclo di vita del punto di accesso. Tipo: String Valori validi: `creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateAccessPoint_ResponseSyntax) ** Il nome del punto di accesso. Questo è il valore del tag `Name`. Tipo: String ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) ** Identifica il proprietario della Account AWS risorsa del punto di accesso. Tipo: String Limitazioni di lunghezza: lunghezza massima di 14. Modello: `^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) ** L'identità POSIX completa, inclusi l'ID utente, l'ID di gruppo e il gruppo secondario IDs sul punto di accesso utilizzato per tutte le operazioni sui file dai client NFS che utilizzano il punto di accesso. Tipo: oggetto [PosixUser](API_PosixUser.md) ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** La directory nel file system EFS che il punto di accesso espone come directory principale ai client NFS che utilizzano il punto di accesso. Tipo: oggetto [RootDirectory](API_RootDirectory.md) ** [Tags](#API_CreateAccessPoint_ResponseSyntax) ** I tag associati al punto di accesso, presentati come una serie di oggetti Tag. Tipo: matrice di oggetti [Tag](API_Tag.md) ## Errori ** AccessPointAlreadyExists ** Restituito se il punto di accesso che state tentando di creare esiste già, con il token di creazione fornito nella richiesta. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 409 ** AccessPointLimitExceeded ** Restituito se Account AWS ha già creato il numero massimo di punti di accesso consentiti per file system. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 403 ** BadRequest ** Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 400 ** FileSystemNotFound ** Restituito se il `FileSystemId` valore specificato non esiste nel file del richiedente. Account AWS ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Restituito se lo stato del ciclo di vita del file system non è “disponibile”. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 409 ** InternalServerError ** Restituito se si è verificato un errore lato server. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 500 ** ThrottlingException ** Restituito quando l'azione `CreateAccessPoint` API viene richiamata troppo rapidamente e il numero di punti di accesso sul file system si avvicina al [limite di 120](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 429 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)