Sintassi della richiesta URIParametri della richiesta Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

CreateAccessPoint

Crea un punto di EFS accesso. Un punto di accesso è una visualizzazione specifica dell'applicazione di un EFS file system che applica un utente e un gruppo del sistema operativo e un percorso del file system a qualsiasi richiesta di file system effettuata tramite il punto di accesso. L'utente e il gruppo del sistema operativo hanno la precedenza su qualsiasi informazione di identità fornita 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, vedere Montaggio di un file system utilizzando punti di EFS accesso.

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 sono specificati nell'azione di creazione, IAM esegue un'autorizzazione aggiuntiva sull'elasticfilesystem:TagResourceazione 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"
      }
   ]
}

URIParametri della richiesta

La richiesta non utilizza alcun URI parametro.

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

ClientToken

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

▬Tipo: stringa

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

Modello: .+

Campo obbligatorio: sì

FileSystemId

L'ID del EFS file system a cui il punto di accesso fornisce l'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

Speciifica la directory del EFS file system che il punto di accesso espone come directory principale del file system ai NFS client che utilizzano il punto di accesso. I client che utilizzano il punto di accesso possono accedere solo alla directory principale e sotto a questa. Se il RootDirectory valore > Path specificato non esiste, Amazon lo EFS crea e applica le CreationInfo impostazioni 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, Own GID 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 Tagging AWS resources nella AWS General Reference Guide.

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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

AccessPointArn

L'unico Amazon Resource Name (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 AmazonEFS.

▬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 pari a 1. La lunghezza massima è 64 caratteri.

Modello: .+

FileSystemId

L'ID del EFS file system a cui si riferisce 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 Account AWS proprietario 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

L'POSIXidentità 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 NFS client che utilizzano il punto di accesso.

Tipo: oggetto PosixUser

RootDirectory

La directory sul EFS file system che il punto di accesso espone come directory principale ai NFS client 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.

HTTPCodice di stato: 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.

HTTPCodice di stato: 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.

HTTPCodice di stato: 400

FileSystemNotFound

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

HTTPCodice di stato: 404

IncorrectFileSystemLifeCycleState

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

HTTPCodice di stato: 409

InternalServerError

Restituito se si è verificato un errore lato server.

HTTPCodice di stato: 500

ThrottlingException

Restituito quando l'CreateAccessPointAPIazione viene richiamata troppo rapidamente e il numero di punti di accesso sul file system si avvicina al limite di 120.

HTTPCodice di stato: 429

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, 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