Sintassi della richiesta Parametri della richiesta URI:Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

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. Per ulteriori informazioni, vedi Montaggio di un file system utilizzando i punti di accesso EFS.

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 di 1.000 punti di accesso, è possibile che si verifichi una risposta limitata per queste 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.

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

Una stringa composta da un massimo di 64 caratteri ASCII che Amazon EFS utilizza per garantire una creazione idempotente.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 64 caratteri.

Modello: .+

Campo obbligatorio: sì

FileSystemId

ID del file system EFS a cui si applica il punto di accesso.

Tipo: stringa

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})$

Campo obbligatorio: sì

PosixUser

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

Campo obbligatorio: no

RootDirectory

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

Campo obbligatorio: no

Tags

Crea tag associati al punto di accesso. Ciascun tag è una coppia chiave-valore e ogni chiave deve essere univoca. Per ulteriori informazioni, consulta Assegnazione di tag alle risorse AWS nella Guida di riferimento generale di AWS.

Tipo: matrice di oggetti Tag

Campo 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

Il nome della risorsa Amazon (ARN) associato al punto di accesso.

Tipo: stringa

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

L'ID del punto di accesso, assegnato da Amazon EFS.

Tipo: stringa

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

La stringa opaca specificata nella richiesta per garantire la creazione idempotent.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 64 caratteri.

Modello: .+

FileSystemId

ID del file system EFS a cui si applica il punto di accesso.

Tipo: stringa

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

Identifica la fase del ciclo di vita del punto di accesso.

Tipo: stringa

Name

Il nome del punto di accesso. Questo è il valore del tag Name.

Tipo: stringa

OwnerId

Identifica il proprietario (Account AWS) della risorsa del punto di accesso.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 14.

Modello: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PosixUser

Identità POSIX completa, inclusi ID utente, ID gruppo e ID gruppo secondario sul punto di accesso utilizzato per tutte le operazioni di file dai client NFS che utilizzano il punto di accesso.

Tipo: oggetto PosixUser

RootDirectory

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

Tags

I tag associati al punto di accesso, presentati come una serie di oggetti Tag.

Tipo: matrice di oggetti Tag

Errori

AccessPointAlreadyExists

Restituito se il punto di accesso che state tentando di creare esiste già, con il token di creazione fornito nella richiesta.

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.

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.

Codice di stato HTTP: 400

FileSystemNotFound

Restituito se il valore FileSystemId specificato non esiste in Account AWS del richiedente.

Codice di stato HTTP: 404

IncorrectFileSystemLifeCycleState

Restituito se lo stato del ciclo di vita del file system non è “disponibile”.

Codice di stato HTTP: 409

InternalServerError

Restituito se si è verificato un errore lato server.

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.

Codice di stato HTTP: 429

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Azioni

CreateFileSystem