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à.
# Operazioni
Sono supportate le operazioni seguenti:
+ [CreateAccessPoint](API_CreateAccessPoint.md)
+ [CreateFileSystem](API_CreateFileSystem.md)
+ [CreateMountTarget](API_CreateMountTarget.md)
+ [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md)
+ [CreateTags](API_CreateTags.md)
+ [DeleteAccessPoint](API_DeleteAccessPoint.md)
+ [DeleteFileSystem](API_DeleteFileSystem.md)
+ [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md)
+ [DeleteMountTarget](API_DeleteMountTarget.md)
+ [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md)
+ [DeleteTags](API_DeleteTags.md)
+ [DescribeAccessPoints](API_DescribeAccessPoints.md)
+ [DescribeAccountPreferences](API_DescribeAccountPreferences.md)
+ [DescribeBackupPolicy](API_DescribeBackupPolicy.md)
+ [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md)
+ [DescribeFileSystems](API_DescribeFileSystems.md)
+ [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md)
+ [DescribeMountTargets](API_DescribeMountTargets.md)
+ [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md)
+ [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md)
+ [DescribeTags](API_DescribeTags.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md)
+ [PutAccountPreferences](API_PutAccountPreferences.md)
+ [PutBackupPolicy](API_PutBackupPolicy.md)
+ [PutFileSystemPolicy](API_PutFileSystemPolicy.md)
+ [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateFileSystem](API_UpdateFileSystem.md)
+ [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md)
# 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)
# CreateFileSystem
Crea un nuovo file system vuoto. Nella richiesta, l'operazione richiede un token di creazione che Amazon EFS utilizza per garantire una creazione idempotente (chiamare l'operazione con lo stesso token non ha effetto). Se attualmente non esiste un file system di proprietà del chiamante Account AWS con il token di creazione specificato, questa operazione esegue le seguenti operazioni:
+ Crea un nuovo file system vuoto. Il file system avrà un ID assegnato da Amazon EFS e uno stato iniziale `creating` per il ciclo di vita.
+ Restituisce la descrizione del file system creato.
In caso contrario, questa operazione restituisce un errore `FileSystemAlreadyExists` con l'ID del file system esistente.
**Nota**
Per i casi d'uso di base, è possibile utilizzare un UUID generato in modo casuale per il token di creazione.
L'operazione idempotente consente di tentare nuovamente una chiamata `CreateFileSystem` senza rischiare di creare un ulteriore file system. Questo può accadere quando una prima chiamata ha esito negativo senza fornire indicazioni certe sull'effettiva creazione del file system. Un esempio potrebbe essere il verificarsi di un timeout a livello di trasporto o il ripristino della connessione. Se si utilizza lo stesso token di creazione e la chiamata iniziale è riuscita a creare un file system, con l'errore `FileSystemAlreadyExists` il client saprà della sua esistenza.
Per ulteriori informazioni, consulta la sezione relativa alla [Creazione di un file system](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1) della *Guida per l'utente di Amazon EFS*.
**Nota**
La chiamata `CreateFileSystem` risponde mentre il ciclo di vita del file system è ancora `creating`. È possibile controllare lo stato di creazione del file system chiamando l'operazione [DescribeFileSystems](API_DescribeFileSystems.md) che, tra altri elementi, ne restituirà lo stato.
L'operazione include anche un parametro `PerformanceMode` opzionale che è possibile scegliere per il file system. Consigliamo l'uso `generalPurpose` `PerformanceMode` per tutti i file system. La `maxIO` modalità è un tipo di prestazioni della generazione precedente progettata per carichi di lavoro altamente parallelizzati che possono tollerare latenze più elevate rispetto alla modalità. `generalPurpose` `MaxIO`la modalità non è supportata per i file system One Zone o per i file system che utilizzano la velocità effettiva elastica.
Non `PerformanceMode` può essere modificata dopo la creazione del file system. Per ulteriori informazioni, consulta [Amazon EFS: modalità prestazionali](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html).
È possibile impostare la modalità di throughput per il file system utilizzando il parametro `ThroughputMode`.
Una volta completamente creato il file system, Amazon EFS ne imposta lo stato del ciclo di vita su `available`. A questo punto è possibile creare una o più target di montaggio per il file system nel VPC. Per ulteriori informazioni, consulta [CreateMountTarget](API_CreateMountTarget.md). Puoi montare il tuo file system Amazon EFS su un' EC2 istanza nel tuo VPC utilizzando la destinazione di montaggio. Per ulteriori informazioni, consulta [Amazon EFS: come funziona](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:CreateFileSystem`.
I file system 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/file-systems HTTP/1.1
Content-type: application/json
{
"AvailabilityZoneName": "string",
"Backup": boolean,
"CreationToken": "string",
"Encrypted": boolean,
"KmsKeyId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **
Per i file system One Zone, specifica la zona di AWS disponibilità in cui creare il file system. Utilizzare il formato `us-east-1a` per specificare la zona di disponibilità. Per ulteriori informazioni sui file system One Zone, consulta i [tipi di file system EFS](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) nella *Amazon EFS User Guide*.
I file system One Zone non sono disponibili in tutte le zone di disponibilità in Regioni AWS cui è disponibile Amazon EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
Obbligatorio: no
** [Backup](#API_CreateFileSystem_RequestSyntax) **
Specifica se i backup automatici sono abilitati sul file system che si sta creando. Imposta il valore su `true` per abilitare i backup automatici. Se stai creando un file system a zona singola, i backup automatici sono abilitati per impostazione predefinita. Per ulteriori informazioni, consulta [Backup automatici](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) nella *Guida per l'utente di Amazon EFS*.
Il valore predefinito è “`false`”. Tuttavia, se si specifica `AvailabilityZoneName`, l'impostazione predefinita è `true`.
AWS Backup non è disponibile in tutti i paesi in Regioni AWS cui è disponibile Amazon EFS.
Tipo: Booleano
Obbligatorio: no
** [CreationToken](#API_CreateFileSystem_RequestSyntax) **
Stringa contenente un massimo di 64 caratteri ASCII. Amazon EFS utilizza questo sistema per garantire la creazione idempotente.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
Obbligatorio: sì
** [Encrypted](#API_CreateFileSystem_RequestSyntax) **
Un valore booleano che, se true, crea un file system crittografato. Quando crei un file system crittografato, hai la possibilità di specificare una AWS Key Management Service chiave esistente (chiave KMS). Se non specifichi una chiave KMS, la chiave KMS predefinita per Amazon EFS, `/aws/elasticfilesystem`, viene utilizzata per proteggere il file system crittografato.
Tipo: Booleano
Obbligatorio: no
** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) **
L'ID della chiave KMS che si desidera utilizzare per proteggere il file system crittografato. Questo parametro è necessario solo se desideri utilizzare una chiave KMS non predefinita. Se il parametro non è specificato, viene utilizzata la chiave KMS predefinita per Amazon EFS. È possibile specificare un ID chiave KMS utilizzando i seguenti formati:
+ ID chiave: un identificatore univoco della chiave, ad esempio `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ ARN: un ARN (Amazon Resource Name) per la chiave, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ Alias chiave: un nome di visualizzazione creato in precedenza per una chiave, ad esempio `alias/projectKey1`.
+ ARN alias della chiave: un ARN per un alias della chiave, ad esempio `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
[Se si utilizza`KmsKeyId`, è necessario impostare il parametro:Encrypted su trueCreateFileSystem.](#efs-CreateFileSystem-request-Encrypted)
EFS accetta solo chiavi KMS simmetriche. Non puoi usare chiavi KMS asimmetriche con i file system Amazon EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 2048.
Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
Obbligatorio: no
** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) **
Le modalità di prestazioni dei file system. Consigliamo la modalità Prestazioni `generalPurpose` per la maggior parte dei file system. I file system che utilizzano la performance `maxIO` sono in grado di ridimensionare le risorse a livelli maggiori di throughput aggregato e di operazioni al secondo, con un compromesso di latenze leggermente più elevate per la maggior parte delle operazioni sui file. La modalità prestazionale non può essere modificata dopo la creazione del file system. La modalità `maxIO` non è supportata sui file system a zona singola.
A causa delle più elevate latenze per operazione con I/O max, consigliamo di utilizzare la modalità prestazionale a scopi generali per tutti i file system.
Il valore predefinito è “`generalPurpose`”.
Tipo: String
Valori validi: `generalPurpose | maxIO`
Campo obbligatorio: no
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) **
La velocità effettiva, misurata in mebibyte al secondo (MiBps), che desideri fornire per il file system che stai creando. Obbligatorio se `ThroughputMode` è impostato su `provisioned`. I valori validi sono 1-3414 MiBps, con il limite superiore a seconda della regione. Per aumentare questo limite, contatta. Supporto Per ulteriori informazioni, consulta [Quote di Amazon EFS che è possibile incrementare](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) nella *Guida per l'utente di Amazon EFS*.
Tipo: numero a doppia precisione
Intervallo valido: valore minimo di 1.0.
Obbligatorio: no
** [Tags](#API_CreateFileSystem_RequestSyntax) **
Utilizza per creare uno o più tag associati al file system. Ogni tag è una coppia chiave-valore definita dall'utente. Denominare il file system quando viene creato, includendo una coppia chiave-valore `"Key":"Name","Value":"{value}"`. Ogni chiave deve essere univoca. Per ulteriori informazioni, consulta [Taggare AWS le risorse](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) nella *Guida di riferimento AWS generale*.
Tipo: matrice di oggetti [Tag](API_Tag.md)
Obbligatorio: no
** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) **
Specifica la modalità della velocità di trasmissione effettiva per il file system. La modalità può essere `bursting`, `provisioned` o `elastic`. Se `ThroughputMode` è impostato su `provisioned`, è necessario impostare anche un valore per `ProvisionedThroughputInMibps`. Dopo avere creato il file system, puoi ridurre la velocità di trasmissione effettiva del file system nella modalità con provisioning o passare a un'altra modalità di velocità di trasmissione effettiva, con determinate limitazioni di tempo. Per ulteriori informazioni, consulta [Specifica del throughput nella modalità Provisioned](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput) nella *Guida per l'utente di Amazon EFS.*
Il valore predefinito è “`bursting`”.
Tipo: String
Valori validi: `bursting | provisioned | elastic`
Campo obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 201
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) **
L'identificatore univoco e coerente della zona di disponibilità in cui si trova il file system, valido solo per i file system a zona singola. Ad esempio, `use1-az1` è un ID della zona di disponibilità per Regione AWS us-east-1 e ha la stessa posizione in tutti. Account AWS
Tipo: String
** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) **
Descrive la zona di AWS disponibilità in cui si trova il file system ed è valido solo per i file system a zona singola. Per ulteriori informazioni, consulta [Utilizzo delle classi di archiviazione EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) nella *Guida per l'utente di Amazon EFS*.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
** [CreationTime](#API_CreateFileSystem_ResponseSyntax) **
L'ora di creazione del file system, in secondi (da 1970-01-01T00:00:00Z).
Tipo: Timestamp
** [CreationToken](#API_CreateFileSystem_ResponseSyntax) **
Stringa opaca specificata nella richiesta.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
** [Encrypted](#API_CreateFileSystem_ResponseSyntax) **
Valore booleano che, se "true", indica che il file system è crittografato.
Tipo: Booleano
** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) per il file system Amazon EFS in formato `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Esempio con dati campione: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Tipo: String
** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) **
L'ID del file system, assegnato da Amazon EFS.
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})$`
** [FileSystemProtection](#API_CreateFileSystem_ResponseSyntax) **
Descrive la protezione del file system.
Tipo: oggetto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) **
L'ID di un file AWS KMS key utilizzato per proteggere il file system crittografato.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 2048.
Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_CreateFileSystem_ResponseSyntax) **
La fase del ciclo di vita del file system.
Tipo: String
Valori validi: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateFileSystem_ResponseSyntax) **
È possibile aggiungere tag a un file system, incluso un tag `Name`. Per ulteriori informazioni, consulta [CreateFileSystem](#API_CreateFileSystem). Se il file system ha un tag `Name`, Amazon EFS restituisce il valore in questo campo.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 256.
Modello: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) **
Il numero attuale di target di montaggio del file system. Per ulteriori informazioni, consulta [CreateMountTarget](API_CreateMountTarget.md).
Tipo: numero intero
Intervallo valido: valore minimo di 0.
** [OwnerId](#API_CreateFileSystem_ResponseSyntax) **
Quello Account AWS che ha creato il file system.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 14.
Modello: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) **
Le modalità di prestazioni dei file system.
Tipo: String
Valori validi: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) **
La quantità di velocità effettiva assegnata, misurata in MiBps, per il file system. Valido per i file system che utilizzano `ThroughputMode` impostato su `provisioned`.
Tipo: numero a doppia precisione
Intervallo valido: valore minimo di 1.0.
** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) **
L'ultima dimensione misurata nota (in byte) dei dati memorizzati nel file system, nel relativo campo `Value` e l'ora in cui tale dimensione è stata determinata nel campo `Timestamp`. Il valore `Timestamp` è il numero intero di secondi dal 1970-01-01T00:00:00Z. Il valore `SizeInBytes` non rappresenta la dimensione di un'istantanea coerente del file system, ma è coerente quando non vi sono operazioni di scrittura sul file system. Ossia, `SizeInBytes` rappresenta la dimensione effettiva solo se il file system non viene modificato per un periodo superiore a un paio d'ore. Altrimenti, il valore non corrisponde alla dimensione esatta che aveva il file system in qualsiasi momento.
Tipo: oggetto [FileSystemSize](API_FileSystemSize.md)
** [Tags](#API_CreateFileSystem_ResponseSyntax) **
I tag associati al file system, presentati come una serie di oggetti `Tag`.
Tipo: matrice di oggetti [Tag](API_Tag.md)
** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) **
Visualizza la modalità di throughput per un file system. Per ulteriori informazioni, consulta [Modalità di throughput](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) nella *Guida per l'utente di Amazon EFS*.
Tipo: String
Valori validi: `bursting | provisioned | elastic`
## Errori
** 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
** FileSystemAlreadyExists **
Restituito se il file system che si sta cercando di creare esiste già, con il token di creazione fornito.
** 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
** FileSystemLimitExceeded **
Restituito se Account AWS ha già creato il numero massimo di file system consentiti per account.
** 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
** InsufficientThroughputCapacity **
Restituito se la capacità non è sufficiente per fornire un throughput aggiuntivo. Questo valore può essere restituito quando si tenta di creare un file system in modalità di throughput assegnato, quando si tenta di aumentare la velocità di trasmissione effettiva assegnata di un file system esistente o quando si tenta di modificare un file system esistente dalla modalità Bursting alla modalità Con provisioning. Riprova più tardi.
** 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: 503
** 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
** ThroughputLimitExceeded **
Restituito se la modalità di throughput o la quantità di throughput assegnata non possono essere modificate perché è stato raggiunto il limite di throughput di MiB/s 1024.
** 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
** UnsupportedAvailabilityZone **
Restituito se la funzionalità Amazon EFS richiesta non è disponibile nella zona di disponibilità specificata.
** 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
## Esempi
### Creazione di un file system EFS crittografato
L'esempio seguente invia una richiesta POST per creare un file system nella regione `us-west-2` con i backup automatici abilitati. La richiesta specifica `myFileSystem1` come token di creazione per l'idempotenza.
#### Richiesta di esempio
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem1",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"Encrypted": true,
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Risposta di esempio
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
### Creazione di un file system EFS crittografato con disponibilità a zona singola
L'esempio seguente invia una richiesta POST per creare un file system nella regione `us-west-2` con i backup automatici abilitati. Il file system disporrà di una sola zona di archiviazione nella zona di disponibilità `us-west-2b`.
#### Richiesta di esempio
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem2",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"AvailabilityZoneName": "us-west-2b",
"Encrypted": true,
"ThroughputMode": "elastic",
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Risposta di esempio
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"AvailabilityZoneId": "usew2-az2",
"AvailabilityZoneName": "us-west-2b",
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem)
# CreateMountTarget
Crea un target di montaggio per un file system. È quindi possibile montare il file system sulle EC2 istanze utilizzando la destinazione di montaggio. Per ulteriori informazioni sulle destinazioni di montaggio, vedere [Gestione delle destinazioni di montaggio](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html).
Per creare una destinazione di montaggio per un file system EFS, lo stato del ciclo di vita del file system deve essere. `available` Per ulteriori informazioni, consulta [DescribeFileSystems](API_DescribeFileSystems.md).
Dopo aver creato la destinazione di montaggio, Amazon EFS restituisce una risposta che include un indirizzo IP `MountTargetId` e un indirizzo IP (`IpAddress`o`Ipv6Address`). Utilizzi questo indirizzo IP per montare il file system in un' EC2 istanza. Durante il montaggio del file system è anche possibile utilizzare il nome DNS del target di montaggio. L' EC2 istanza su cui si monta il file system utilizzando la destinazione di montaggio può risolvere il nome DNS della destinazione di montaggio nel relativo indirizzo IP. Per ulteriori informazioni, consulta [Come funziona Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Tieni presente che è possibile creare target di montaggio per un file system in un solo VPC e che può esserci un solo target di montaggio per ogni zona di disponibilità. Per ulteriori informazioni, consulta [Creazione di target di montaggio](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html).
Se la richiesta soddisfa i requisiti, Amazon EFS procede in questo modo:
+ Crea un nuovo target di montaggio nella sottorete specificata.
+ Crea una nuova interfaccia di rete nella sottorete con quanto segue:
+ La descrizione `Mount target fsmt-id for file system fs-id ` dove ` fsmt-id ` è l'ID del target di montaggio, ed ` fs-id ` è. `FileSystemId`
+ La `requesterManaged` proprietà dell'interfaccia di rete è impostata su e il `requesterId` valore impostato su`EFS`. `true`
Ogni destinazione di montaggio ha una corrispondente interfaccia di EC2 rete gestita dal richiedente. Dopo aver creato l'interfaccia di rete, Amazon EFS imposta il `NetworkInterfaceId` campo nella descrizione della destinazione di montaggio sull'ID dell'interfaccia di rete e l'indirizzo IP sul relativo indirizzo. Se la creazione dell'interfaccia di rete non riesce, l'intera operazione `CreateMountTarget` ha esito negativo.
**Nota**
La chiamata `CreateMountTarget` restituisce solo dopo aver creato l'interfaccia di rete ma, mentre il target di montaggio è ancora in stato `creating`, è possibile controllarne lo stato di creazione chiamando l'operazione [DescribeMountTargets](API_DescribeMountTargets.md) che, tra l’altro, restituirà lo stato del target di montaggio.
Questa operazione richiede autorizzazioni per le seguenti operazioni sul file system:
+ `elasticfilesystem:CreateMountTarget`
Questa operazione richiede anche le autorizzazioni per le seguenti EC2 azioni Amazon:
+ `ec2:DescribeSubnets`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:CreateNetworkInterface`
## Sintassi della richiesta
```
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string",
"IpAddress": "string",
"IpAddressType": "string",
"Ipv6Address": "string",
"SecurityGroups": [ "string" ],
"SubnetId": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **
L'ID del file system per il quale creare il target di montaggio.
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ì
** [IpAddress](#API_CreateMountTarget_RequestSyntax) **
Se `IpAddressType` for the mount target è IPv4 (`IPV4_ONLY`o`DUAL_STACK`), specifica l' IPv4 indirizzo da utilizzare. Se non lo specifichi`IpAddress`, Amazon EFS seleziona un indirizzo IP inutilizzato dalla sottorete specificata per. `SubnetId`
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 7. La lunghezza massima è 15 caratteri.
Modello: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
Obbligatorio: no
** [IpAddressType](#API_CreateMountTarget_RequestSyntax) **
Il tipo di indirizzo IP per la destinazione di montaggio. I valori possibili sono `IPV4_ONLY` (solo IPv4 indirizzi), `IPV6_ONLY` (solo IPv6 indirizzi) e `DUAL_STACK` (dual-stack, entrambi IPv4 e IPv6 indirizzi). Se non si specifica un`IpAddressType`, allora viene `IPV4_ONLY` utilizzato.
`IPAddressType`Deve corrispondere al tipo di IP della sottorete. Inoltre, il `IPAddressType` parametro sostituisce il valore impostato come indirizzo IP predefinito per la sottorete nel VPC. Ad esempio, se `IPAddressType` è `IPV4_ONLY` ed è`true`, allora `AssignIpv6AddressOnCreation` IPv4 viene utilizzato per la destinazione di montaggio. Per ulteriori informazioni, consulta la sezione [Modifica dell'attributo di assegnazione degli indirizzi IP della sottorete](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html).
Tipo: String
Valori validi: `IPV4_ONLY | IPV6_ONLY | DUAL_STACK`
Campo obbligatorio: no
** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) **
Se `IPAddressType` for the mount target è IPv6 (`IPV6_ONLY`o`DUAL_STACK`), allora specifica l' IPv6 indirizzo da utilizzare. Se non lo specifichi`Ipv6Address`, Amazon EFS seleziona un indirizzo IP inutilizzato dalla sottorete specificata per. `SubnetId`
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. Lunghezza massima di 39.
Obbligatorio: no
** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) **
Gruppo di sicurezza VPC IDs, del modulo. `sg-xxxxxxxx` Questi devono essere per lo stesso VPC della sottorete specificata. Il numero massimo di gruppi di sicurezza dipende dalla quota dell'account. **Per ulteriori informazioni, consulta [Amazon VPC Quotas nella Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) *User Guide* (consulta la tabella dei gruppi di sicurezza).** Se non specifichi un gruppo di sicurezza, Amazon EFS utilizza il gruppo di sicurezza predefinito per il VPC della sottorete.
Tipo: array di stringhe
Membri della matrice: numero massimo di 100 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 11. La lunghezza massima è 43 caratteri.
Modello: `^sg-[0-9a-f]{8,40}`
Obbligatorio: no
** [SubnetId](#API_CreateMountTarget_RequestSyntax) **
L'ID della sottorete in cui aggiungere il target di montaggio. Per i file system a zona singola, utilizza la sottorete associata alla zona di disponibilità del file system. Il tipo di sottorete deve essere dello stesso tipo di. `IpAddressType`
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 15. La lunghezza massima è 47 caratteri.
Modello: `^subnet-[0-9a-f]{8,40}$`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "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.
** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) **
L'identificatore univoco e coerente della zona di disponibilità in cui risiede il target di montaggio. Ad esempio, `use1-az1` è un ID AZ per la regione us-east-1 e ha la stessa posizione in ogni. Account AWS
Tipo: String
** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) **
Il nome della zona di disponibilità in cui si trova il target di montaggio. Le zone di disponibilità sono mappate indipendentemente in base ai nomi di ciascuna. Account AWS Ad esempio, la zona `us-east-1a` di disponibilità dell'utente Account AWS potrebbe non corrispondere a quella `us-east-1a` di un'altra Account AWS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) **
L'ID del file system per il quale creare il target di montaggio.
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})$`
** [IpAddress](#API_CreateMountTarget_ResponseSyntax) **
L' IPv4 indirizzo per la destinazione di montaggio.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 7. La lunghezza massima è 15 caratteri.
Modello: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) **
L' IPv6 indirizzo per il target di montaggio.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. Lunghezza massima di 39.
** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) **
Stato del ciclo di vita del target di montaggio.
Tipo: String
Valori validi: `creating | available | updating | deleting | deleted | error`
** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) **
ID del target di montaggio assegnato dal sistema.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.
Modello: `^fsmt-[0-9a-f]{8,40}$`
** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) **
L'ID dell'interfaccia di rete creata da Amazon EFS al momento della creazione del target di montaggio.
Tipo: String
** [OwnerId](#API_CreateMountTarget_ResponseSyntax) **
Account AWS ID proprietario della risorsa.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 14.
Modello: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SubnetId](#API_CreateMountTarget_ResponseSyntax) **
L'ID della sottorete del target di montaggio.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 15. La lunghezza massima è 47 caratteri.
Modello: `^subnet-[0-9a-f]{8,40}$`
** [VpcId](#API_CreateMountTarget_ResponseSyntax) **
L'ID del cloud privato virtuale (VPC) in cui è configurato il target di montaggio.
Tipo: String
## Errori
** AvailabilityZonesMismatch **
Restituito se la zona di disponibilità specificata per la destinazione di montaggio è diversa dalla zona di disponibilità del file system. Per ulteriori informazioni, consulta [Ridondanza dello storage a livello regionale e a zona unica](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs).
** 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
** 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 nella cartella 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
** IpAddressInUse **
Restituito se la richiesta ha specificato un indirizzo IP (`IpAddress`o`Ipv6Address`) che è già in uso nella sottorete.
** 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
** MountTargetConflict **
Restituito se il target di montaggio viola una delle restrizioni specificate in base ai target di montaggio esistenti del file system.
** 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
** NetworkInterfaceLimitExceeded **
L'account chiamante ha raggiunto il limite per le interfacce di rete elastiche per lo specifico Regione AWS. Elimina alcune interfacce di rete o richiedi l'aumento della quota dell'account. Per ulteriori informazioni, consulta [Quote di Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) nella *Guida per l’utente di Amazon VPC* (vedi la voce **Interfacce di rete per regione** nella tabella **Interfacce di rete**).
** 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
** NoFreeAddressesInSubnet **
Ha restituito no `IpAddress` o `Ipv6Address` è stato fornito nella richiesta e non ci sono indirizzi IP liberi nella sottorete specificata.
** 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
** SecurityGroupLimitExceeded **
Restituito se il numero `SecurityGroups` specificato nella richiesta è superiore al limite, che si basa sulla quota dell'account. Elimina alcuni gruppi di sicurezza o richiedi l'aumento della quota dell'account. **Per ulteriori informazioni, consulta [Amazon VPC Quotas nella Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) *User Guide* (consulta la tabella dei gruppi di sicurezza).**
** 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
** SecurityGroupNotFound **
Restituito se uno dei gruppi di sicurezza specificati non esiste nel cloud privato virtuale (VPC) della sottorete.
** 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
** SubnetNotFound **
Restituito se non è presente alcuna sottorete con l'ID `SubnetId` 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: 400
** UnsupportedAvailabilityZone **
Restituito se la funzionalità Amazon EFS richiesta non è disponibile nella zona di disponibilità specificata.
** 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
## Esempi
### Crea un target di montaggio a un IPv4 indirizzo disponibile su una sottorete
La richiesta seguente specifica solo il file system e la sottorete per la destinazione di montaggio. La destinazione viene creata a un IPv4 indirizzo disponibile nella sottorete specificata, con il gruppo di sicurezza predefinito associato al VPC.
#### Richiesta di esempio
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crea un target di montaggio a un indirizzo specifico IPv4
La richiesta seguente specifica il file system, la sottorete, il gruppo di sicurezza e l' IPv4indirizzo da utilizzare per la destinazione di montaggio.
#### Richiesta di esempio
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddress":"10.0.2.42",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crea una destinazione di montaggio a un indirizzo specifico IPv6
La richiesta seguente specifica il file system, la sottorete, il gruppo di sicurezza e l' IPv6indirizzo da utilizzare per la destinazione di montaggio.
#### Richiesta di esempio
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"IpAddressType": "IPV6_ONLY",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crea una destinazione di montaggio a un IPv4 indirizzo disponibile su una sottorete dual-stack
La richiesta seguente specifica il file system, la sottorete e il tipo di indirizzo per la destinazione di montaggio. La destinazione viene creata a un IPv4 indirizzo disponibile nella sottorete dual-stack specificata, con il gruppo di sicurezza predefinito associato al VPC.
#### Richiesta di esempio
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "251839141158",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Crea un target di montaggio su Ipv4 e indirizzi specifici su una sottorete dual-stack IPv6
La seguente richiesta specifica il file system, la sottorete, il gruppo di sicurezza, l'indirizzo e l'indirizzo per la destinazione di montaggio. IPv4 IPv6 La destinazione viene creata all' IPv6indirizzo IPv4 e specificato su una sottorete dual-stack.
#### Richiesta di esempio
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddressType": "DUAL_STACK",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget)
# CreateReplicationConfiguration
Crea una configurazione di replica su un file system EFS nuovo o esistente. Per ulteriori informazioni, consulta [Replica Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) nella *Guida per l'utente di Amazon EFS*. La configurazione di replica specifica quanto segue:
+ **File system di origine**: il file system EFS che si desidera replicare.
+ **File system di destinazione**: il file system di destinazione in cui viene replicato il file system di origine. In una configurazione di replica può esistere un solo file system di destinazione.
**Nota**
Un file system può far parte di una sola configurazione di replica.
I parametri di destinazione per la configurazione di replica dipendono dal fatto che si stia eseguendo la replica su un nuovo file system o su un file system esistente e se si stia eseguendo la replica su più file. Account AWS Per ulteriori informazioni, consulta [DestinationToCreate](API_DestinationToCreate.md).
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:CreateReplicationConfiguration`. Inoltre, sono necessarie altre autorizzazioni a seconda della modalità di replica dei file system. Per ulteriori informazioni, consulta [Autorizzazioni richieste per la replica nella Guida](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions) per l'*utente di Amazon EFS*.
## Sintassi della richiesta
```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string",
"RoleArn": "string"
}
]
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **
Specifica il file system Amazon EFS da replicare. Questo file system non può essere già un file system di origine o di destinazione in un'altra configurazione di replica.
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ì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **
Una matrice di oggetti di configurazione di destinazione. È supportato un solo oggetto di configurazione di destinazione.
Tipo: matrice di oggetti [DestinationToCreate](API_DestinationToCreate.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "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.
** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) **
Descrive quando è stata creata la configurazione di replica.
Tipo: Timestamp
** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **
Una matrice di oggetti di destinazione. È supportato un solo oggetto di destinazione.
Tipo: matrice di oggetti [Destination](API_Destination.md)
** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del file system EFS originale nella configurazione di replica.
Tipo: String
** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del file system EFS originale nella configurazione di replica.
Tipo: String
** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **
ID del file system Amazon EFS di origine che viene replicato.
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})$`
** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **
ID del file system di origine Account AWS in cui risiede.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 14.
Modello: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **
Il file system EFS di origine Regione AWS in cui si trova.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`
## Errori
** 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
** ConflictException **
Restituito se il file system di origine in una replica è crittografato ma il file system di destinazione non è crittografato.
** 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
** FileSystemLimitExceeded **
Restituito se Account AWS è già stato creato il numero massimo di file system consentiti per account.
** 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
** 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
** InsufficientThroughputCapacity **
Restituito se la capacità non è sufficiente per fornire un throughput aggiuntivo. Questo valore può essere restituito quando si tenta di creare un file system in modalità di throughput assegnato, quando si tenta di aumentare la velocità di trasmissione effettiva assegnata di un file system esistente o quando si tenta di modificare un file system esistente dalla modalità Bursting alla modalità Con provisioning. Riprova più tardi.
** 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: 503
** 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
** ReplicationNotFound **
Restituito se il file system specificato non dispone di una configurazione di replica.
** ErrorCode **
ReplicationNotFound
** 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
** ThroughputLimitExceeded **
Restituito se la modalità di throughput o la quantità di throughput assegnata non possono essere modificate perché è stato raggiunto il limite di throughput di 1024. MiB/s
** 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
** UnsupportedAvailabilityZone **
Restituito se la funzionalità Amazon EFS richiesta non è disponibile nella zona di disponibilità specificata.
** 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
** ValidationException **
Restituito se il AWS Backup servizio non è disponibile nel paese Regione AWS in cui è stata effettuata la 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: 400
## 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/CreateReplicationConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
# CreateTags
**Nota**
OBSOLETO: `CreateTags` è obsoleto e non viene mantenuto. Per creare tag per una risorsa EFS, utilizza l'operazione API [TagResource](API_TagResource.md).
Crea o sovrascrive i tag associati a un file system. Ogni tag è una coppia chiave-valore. Se una chiave di tag specificata nella richiesta esiste già nel file system, questa operazione sovrascrive il suo valore con il valore fornito nella richiesta. Se aggiungi il tag `Name` al tuo file system, Amazon EFS lo restituisce nella risposta all'operazione [DescribeFileSystems](API_DescribeFileSystems.md).
Questa operazione richiede l’autorizzazione per l'operazione `elasticfilesystem:CreateTags`.
## Sintassi della richiesta
```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_CreateTags_RequestSyntax) **
L'ID del file system di cui si desidera modificare i tag (String). Questa operazione modifica solo i tag, non il file system.
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ì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Tags](#API_CreateTags_RequestSyntax) **
Una matrice di oggetti `Tag` da aggiungere. Ogni oggetto `Tag` è una coppia chiave-valore.
Tipo: matrice di oggetti [Tag](API_Tag.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
** 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 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
** 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
## 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/CreateTags)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags)
# DeleteAccessPoint
Elimina il punto di accesso specificato. Una volta completata l'eliminazione, i nuovi client non possono più connettersi ai punti di accesso. I client connessi al punto di accesso al momento dell'eliminazione continueranno a funzionare fino a quando non interromperanno la connessione.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DeleteAccessPoint`.
## Sintassi della richiesta
```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **
ID del punto di accesso che si desidera eliminare.
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})$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
** AccessPointNotFound **
Restituito se il `AccessPointId` valore specificato non esiste nel 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
** 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
** 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
## 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/DeleteAccessPoint)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
# DeleteFileSystem
Elimina un file system, annullando definitivamente l'accesso ai suoi contenuti. Al momento della restituzione, il file system non esiste più e non è possibile accedere ai contenuti del file system eliminato.
È necessario eliminare manualmente i target di montaggio allegati a un file system prima di poter eliminare un file system EFS. Questo passaggio viene eseguito automaticamente quando si utilizza la AWS console per eliminare un file system.
**Nota**
Non è possibile eliminare un file system che fa parte di una configurazione di replica EFS. La configurazione di replica deve prima essere eliminata.
Non è possibile eliminare un file system in uso. Se il file system ha target di montaggio, è necessario prima eliminarli. Per ulteriori informazioni, consultare [DescribeMountTargets](API_DescribeMountTargets.md) e [DeleteMountTarget](API_DeleteMountTarget.md).
**Nota**
La chiamata `DeleteFileSystem` risponde mentre lo stato del file system è ancora `deleting`. È possibile verificare lo stato di eliminazione del file system richiamando l'operazione [DescribeFileSystems](API_DescribeFileSystems.md), che restituisce un elenco dei file system presenti nell'account. Se si trasmette l'ID del file system o il token di creazione per il file system eliminato, [DescribeFileSystems](API_DescribeFileSystems.md) restituisce un errore `404 FileSystemNotFound`.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DeleteFileSystem`.
## Sintassi della richiesta
```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **
ID del file system che desideri eliminare.
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ì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
** 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
** FileSystemInUse **
Restituito se un file system dispone di target di montaggio.
** 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
** FileSystemNotFound **
Restituito se il `FileSystemId` valore specificato non esiste in quello 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
** 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
## Esempi
### Eliminazione di un file system
L'esempio seguente invia una richiesta DELETE all'endpoint `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`) per eliminare un file system il cui ID è `fs-01234567`.
#### Richiesta di esempio
```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```
#### Risposta di esempio
```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```
## 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/DeleteFileSystem)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
# DeleteFileSystemPolicy
Elimina `FileSystemPolicy` per il file system specificato. L'impostazione predefinita di `FileSystemPolicy` entra in vigore una volta eliminata la policy esistente. Per ulteriori informazioni sulla policy del file system predefinita, consulta [Uso di policy basate su risorse con EFS](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html).
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DeleteFileSystemPolicy`.
## Sintassi della richiesta
```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **
Specifica il file system EFS per cui eliminare `FileSystemPolicy`.
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ì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
** 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 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
## 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/DeleteFileSystemPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
# DeleteMountTarget
Elimina il target di montaggio specificato.
L'operazione forza la cancellazione di tutti i montaggi del file system, con possibili conseguenze sulle istanze o sulle applicazioni che utilizzano tali montaggi. Per evitare che le applicazioni vengano interrotte bruscamente, potresti prendere in considerazione lo smontaggio di tutti i supporti del target di montaggio, se possibile. L'operazione elimina anche l'interfaccia di rete associata. Le scritture non eseguite potrebbero andare perse, ma il danneggiamento di un target di montaggio mediante questa operazione non danneggia il file system stesso. Il file system creato resta intatto. Puoi montare un' EC2 istanza nel tuo VPC utilizzando un altro target di montaggio.
Questa operazione richiede autorizzazioni per le seguenti operazioni sul file system:
+ `elasticfilesystem:DeleteMountTarget`
**Nota**
La chiamata `DeleteMountTarget` risponde mentre lo stato del target di montaggio è ancora `deleting`. È possibile verificare l'eliminazione del target di montaggio chiamando l'operazione [DescribeMountTargets](API_DescribeMountTargets.md), che restituisce un elenco di descrizioni del target di montaggio per il file system specificato.
L'operazione richiede anche le autorizzazioni per la seguente EC2 azione di Amazon sull'interfaccia di rete del target di montaggio:
+ `ec2:DeleteNetworkInterface`
## Sintassi della richiesta
```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **
L'ID del target di montaggio da eliminare (String).
Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.
Modello: `^fsmt-[0-9a-f]{8,40}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
** 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
** DependencyTimeout **
Il servizio è scaduto nel tentativo di soddisfare la richiesta e il client dovrebbe riprovare a effettuare la chiamata.
** 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: 504
** 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
** MountTargetNotFound **
Restituito se non è presente alcun target di montaggio con l'ID specificato trovato nell' Account AWS del chiamante.
** 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
## Esempi
### Rimozione del target di montaggio di un file system
L'esempio seguente invia una richiesta DELETE per eliminare un target di montaggio specifico.
#### Richiesta di esempio
```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```
#### Risposta di esempio
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/DeleteMountTarget)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
# DeleteReplicationConfiguration
Elimina una configurazione di replica. L'eliminazione di una configurazione di replica termina il processo di replica. Dopo aver eliminato una configurazione di replica, il file system di destinazione diventa `Writeable` e la protezione da sovrascrittura della replica viene riattivata. Per ulteriori informazioni, consulta [Eliminazione della configurazione di replica](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html).
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DeleteReplicationConfiguration`.
## Sintassi della richiesta
```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **
Durante la replica incrociata Account AWS o trasversale Regioni AWS, Amazon EFS elimina la configurazione di replica sia dall'account o dalla regione di origine che di destinazione (`ALL_CONFIGURATIONS`) per impostazione predefinita. Se c'è un problema di configurazione o di autorizzazioni che impedisce ad Amazon EFS di eliminare la configurazione di replica da entrambi i lati, puoi utilizzare la `LOCAL_CONFIGURATION_ONLY` modalità per eliminare la configurazione di replica solo dal lato locale (l'account o la regione da cui viene eseguita l'eliminazione).
Utilizza la `LOCAL_CONFIGURATION_ONLY` modalità solo nel caso in cui Amazon EFS non sia in grado di eliminare la configurazione di replica nell'account o nella regione di origine e di destinazione. L'eliminazione della configurazione locale rende irrecuperabile la configurazione nell'altro account o regione.
Inoltre, non utilizzate questa modalità per la replica dello stesso account e della stessa regione, poiché così facendo si verificherebbe un errore di eccezione. BadRequest
Valori validi: `ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY`
** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) **
L'ID del file system di origine nella configurazione di replica.
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ì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
** 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 in quello 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
** 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
** ReplicationNotFound **
Restituito se il file system specificato non dispone di una configurazione di replica.
** ErrorCode **
ReplicationNotFound
** 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
## 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/DeleteReplicationConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
# DeleteTags
**Nota**
OBSOLETO: `DeleteTags` è obsoleto e non viene mantenuto. Per rimuovere i tag da una risorsa EFS, utilizza l'operazione API [UntagResource](API_UntagResource.md).
Elimina i tag specificati da un file system. Se la richiesta `DeleteTags` include una chiave di tag che non esiste, Amazon EFS la ignora e non causa un errore. Per ulteriori informazioni sui tag e sulle relative restrizioni, consulta Restrizioni relative [ai tag](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *Guida Gestione dei costi e fatturazione AWS per l'utente*.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DeleteTags`.
## Sintassi della richiesta
```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"TagKeys": [ "string" ]
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DeleteTags_RequestSyntax) **
L'ID del file system di cui si desidera eliminare i tag (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ì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [TagKeys](#API_DeleteTags_RequestSyntax) **
Un elenco di chiavi di tag da eliminare.
Tipo: array di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
** 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 in quello 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
** 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
## 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/DeleteTags)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags)
# DescribeAccessPoints
Restituisce la descrizione di un punto di accesso Amazon EFS specifico, se `AccessPointId` viene fornito. Se si fornisce un EFS `FileSystemId`, restituisce le descrizioni di tutti i punti di accesso per quel file system. È possibile fornire un `AccessPointId` o un `FileSystemId` nella richiesta, ma non entrambi.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DescribeAccessPoints`.
## Sintassi della richiesta
```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **
(Facoltativo) Specifica un punto di accesso EFS da descrivere nella risposta; si esclude a vicenda con `FileSystemId`.
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})$`
** [FileSystemId](#API_DescribeAccessPoints_RequestSyntax) **
(Facoltativo) Se si fornisce un `FileSystemId`, EFS restituisce tutti i punti di accesso per quel file system; si esclude a vicenda con `AccessPointId`.
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})$`
** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) **
(Facoltativo) Quando recuperi tutti i punti di accesso per un file system, puoi facoltativamente specificare il parametro `MaxItems` per limitare il numero di oggetti restituiti in una risposta. Il valore predefinito è 100.
Intervallo valido: valore minimo di 1.
** [NextToken](#API_DescribeAccessPoints_RequestSyntax) **
`NextToken` è presente se la risposta è impaginata. È possibile utilizzare `NextMarker` in una richiesta successiva per recuperare la pagina successiva di descrizioni dei punti di accesso.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPoints": [
{
"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"
}
]
}
],
"NextToken": "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.
** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) **
Una serie di descrizioni dei punti di accesso.
Tipo: matrice di oggetti [AccessPointDescription](API_AccessPointDescription.md)
** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **
Presente se ci sono più punti di accesso di quelli restituiti nella risposta. È possibile utilizzare il NextMarker nella richiesta successiva per recuperare le descrizioni aggiuntive.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
## Errori
** AccessPointNotFound **
Restituito se il `AccessPointId` valore specificato non esiste nel 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
** 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 in quello 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
** 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
## 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/DescribeAccessPoints)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
# DescribeAccountPreferences
Restituisce le impostazioni delle preferenze dell'account per l'utente Account AWS associato all'utente che effettua la richiesta, nella versione corrente Regione AWS.
## Sintassi della richiesta
```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **
(Facoltativo) Quando recuperi le preferenze dell'account, puoi facoltativamente specificare il parametro `MaxItems` per limitare il numero di oggetti restituiti in una risposta. Il valore predefinito è 100.
Tipo: numero intero
Intervallo valido: valore minimo di 1.
Obbligatorio: no
** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) **
(Facoltativo) È possibile utilizzare `NextToken` in una richiesta successiva per recuperare la pagina successiva delle preferenze Account AWS se il payload della risposta è stato impaginato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "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.
** [NextToken](#API_DescribeAccountPreferences_ResponseSyntax) **
Presente se ci sono più record di quelli restituiti nella risposta. Puoi utilizzare `NextToken` nella richiesta seguente per recuperare le descrizioni aggiuntive.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) **
Descrive l'impostazione delle preferenze relative all'ID della risorsa Account AWS associata all'utente che effettua la richiesta, nella versione corrente Regione AWS.
Tipo: oggetto [ResourceIdPreference](API_ResourceIdPreference.md)
## Errori
** 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
## 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/DescribeAccountPreferences)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
# DescribeBackupPolicy
Restituisce la policy di backup per il file system EFS specificato.
## Sintassi della richiesta
```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **
Specifica il file system EFS per il quale recuperare `BackupPolicy`.
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ì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "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.
** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) **
Descrive la policy di backup del file system, indicando se i backup automatici sono attivati o disattivati.
Tipo: oggetto [BackupPolicy](API_BackupPolicy.md)
## Errori
** 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 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
** 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
** PolicyNotFound **
Restituito se non è possibile individuare o accedere alla politica IAM o alla politica delle risorse specificata. A seconda dell'azione eseguita, l'errore può essere restituito anche se la politica del file system predefinita è in vigore per il file system EFS o se non viene specificata alcuna politica di backup.
** 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
** ValidationException **
Restituito se il AWS Backup servizio non è disponibile nel paese Regione AWS in cui è stata effettuata la 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: 400
## 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/DescribeBackupPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
# DescribeFileSystemPolicy
Restituisce `FileSystemPolicy` per il file system EFS specificato.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DescribeFileSystemPolicy`.
## Sintassi della richiesta
```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **
Specifica il file system EFS per cui eliminare `FileSystemPolicy`.
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ì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "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.
** [FileSystemId](#API_DescribeFileSystemPolicy_ResponseSyntax) **
Specifica il file system EFS a cui `FileSystemPolicy` si applica.
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})$`
** [Policy](#API_DescribeFileSystemPolicy_ResponseSyntax) **
`FileSystemPolicy` formattato JSON per il file system EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 20000 caratteri.
Modello: `[\s\S]+`
## Errori
** 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 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
** 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
** PolicyNotFound **
Restituito se non è possibile individuare o accedere alla politica IAM o alla politica delle risorse specificata. A seconda dell'azione eseguita, l'errore può essere restituito anche se la politica del file system predefinita è in vigore per il file system EFS o se non viene specificata alcuna politica di backup.
** 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
## Esempi
### Esempio
Questo esempio illustra un utilizzo di. DescribeFileSystemPolicy
#### Richiesta di esempio
```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```
#### Risposta di esempio
```
{
"FileSystemId": "fs-01234567",
"Policy": "{
"Version": "2012-10-17",
"Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect" : "Deny",
"Principal": {
"AWS": "*"
},
"Action": "*",
"Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
"Condition": {
"Bool": {
"aws:SecureTransport": "false"
}
}
},
{
"Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567"
}
]
}
}
```
## 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/DescribeFileSystemPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
# DescribeFileSystems
Restituisce la descrizione di un file system Amazon EFS specifico se viene fornito il file system `CreationToken` o `FileSystemId`. Altrimenti, restituisce le descrizioni di tutti i file system di proprietà del chiamante Account AWS nell' Regione AWS endpoint che stai chiamando.
Quando recuperi tutte le descrizioni dei file system, puoi facoltativamente specificare il parametro `MaxItems` per limitare il numero di descrizioni in una risposta. Questo numero viene impostato automaticamente su 100. Se rimangono altre descrizioni del file system, Amazon EFS restituisce un token `NextMarker` opaco nella risposta. In questo caso, è necessario inviare una richiesta successiva con il parametro `Marker` di richiesta impostato sul valore `NextMarker`.
Per recuperare un elenco delle descrizioni del file system, questa operazione viene utilizzata in un processo iterativo, in cui `DescribeFileSystems` viene chiamato prima senza `Marker`, quindi l'operazione continua a chiamare con il parametro `Marker` impostato sul valore `NextMarker` della risposta precedente fino a quando la risposta non ha `NextMarker`.
L'ordine dei file system restituiti nella risposta di una chiamata `DescribeFileSystems` e l'ordine dei file system restituiti nelle risposte di un'iterazione di più chiamate non è specificato.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DescribeFileSystems`.
## Sintassi della richiesta
```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **
(Facoltativo) Limita l'elenco al file system con questo token di creazione (String). Quando viene creato un file system Amazon EFS, viene specificato un token.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) **
(Facoltativo) ID del file system di cui desideri recuperare la descrizione (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})$`
** [Marker](#API_DescribeFileSystems_RequestSyntax) **
(Facoltativo) Un token di impaginazione opaco restituito dalla precedente operazione `DescribeFileSystems` (String). Se presente, specifica di continuare l'elenco dal punto in cui era stata interrotta la chiamata.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [MaxItems](#API_DescribeFileSystems_RequestSyntax) **
(Facoltativo) Specifica il numero (intero) massimo di file system da restituire nella risposta. Questo numero viene impostato automaticamente su 100. La risposta viene impaginata a 100 per pagina se sono presenti più di 100 file system.
Intervallo valido: valore minimo di 1.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystems": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
],
"Marker": "string",
"NextMarker": "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.
** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) **
Una serie di descrizioni del file system.
Tipo: matrice di oggetti [FileSystemDescription](API_FileSystemDescription.md)
** [Marker](#API_DescribeFileSystems_ResponseSyntax) **
Presente se fornito dal chiamante nella richiesta (String).
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) **
Presente se vi sono più file system di quelli restituiti nella risposta (String). È possibile utilizzare `NextMarker` in una richiesta successiva per recuperare ulteriori descrizioni.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
## Errori
** 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 in quello 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
** 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
## Esempi
### Recupero di un elenco di 10 file system
L'esempio seguente invia una richiesta GET all'endpoint `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`). La richiesta specifica un parametro `MaxItems` di query per limitare il numero di descrizioni del file system a 10.
#### Richiesta di esempio
```
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
"FileSystems":[
{
"OwnerId":"251839141158",
"CreationToken":"MyFileSystem1",
"FileSystemId":"fs-01234567",
"PerformanceMode" : "generalPurpose",
"CreationTime":"1403301078",
"LifeCycleState":"created",
"Name":"my first file system",
"NumberOfMountTargets":1,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
}
}
]
}
```
## 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/DescribeFileSystems)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
# DescribeLifecycleConfiguration
Restituisce l'`LifecycleConfiguration`oggetto corrente per il file system EFS specificato. La gestione del ciclo di vita utilizza l'oggetto `LifecycleConfiguration` per identificare quando spostare i file tra le classi di storage. Per un file system senza oggetto `LifecycleConfiguration`, la chiamata restituisce un array vuoto nella risposta.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DescribeLifecycleConfiguration`.
## Sintassi della richiesta
```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **
L'ID del file system di cui si desidera recuperare l’oggetto `LifecycleConfiguration` (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ì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "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.
** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) **
Una serie di policy di gestione del ciclo di vita. EFS supporta al massimo una policy per file system.
Tipo: matrice di oggetti [LifecyclePolicy](API_LifecyclePolicy.md)
Membri della matrice: numero massimo di 3 elementi.
## Errori
** 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 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
** 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
## Esempi
### Recupero della configurazione del ciclo di vita per un file system
La richiesta seguente recupera l'oggetto `LifecycleConfiguration` per il file system specificato.
#### Richiesta di esempio
```
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
## 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/DescribeLifecycleConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
# DescribeMountTargets
Restituisce le descrizioni di tutti i target di montaggio correnti o un target di montaggio specifico, per un file system. Quando si richiedono tutti i target di montaggio correnti, l'ordine dei target di montaggio restituiti nella risposta non è specificato.
Questa operazione richiede le autorizzazioni per l'azione `elasticfilesystem:DescribeMountTargets`, sull'ID del file system specificato in `FileSystemId` o sul file system del target di montaggio specificato in `MountTargetId`.
Il comando CLI corrispondente è. `describe-mount-targets`
## Sintassi della richiesta
```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **
(Facoltativo) L'ID del punto di accesso di cui desideri elencare i target di montaggio. Deve essere incluso nella richiesta se nella stessa non è incluso `MountTargetId` o `FileSystemId`. Accetta un ID del punto di accesso o un ARN come input.
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})$`
** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) **
(Facoltativo) ID del file system di cui desideri elencare i target di montaggio (String). Deve essere incluso nella richiesta se non è incluso `MountTargetId` o `AccessPointId`. Accetta un ID del file system o un ARN come input.
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})$`
** [Marker](#API_DescribeMountTargets_RequestSyntax) **
(Facoltativo) Un token di impaginazione opaco restituito dalla precedente operazione `DescribeMountTargets` (String). Se presente, specifica di continuare l'elenco dal punto in cui era stata interrotta la chiamata precedente.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **
(Facoltativo) Il numero massimo di target di montaggio da restituire nella risposta. Attualmente, questo numero viene impostato automaticamente su 10 e gli altri valori vengono ignorati. La risposta viene impaginata a 100 per pagina se si dispone di più di 100 target di montaggio.
Intervallo valido: valore minimo di 1.
** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **
(Facoltativo) ID del target di montaggio da descrivere (String). Deve essere incluso nella richiesta se non è incluso `FileSystemId`. Accetta un ID di target di montaggio o un ARN come input.
Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.
Modello: `^fsmt-[0-9a-f]{8,40}$`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"MountTargets": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
],
"NextMarker": "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.
** [Marker](#API_DescribeMountTargets_ResponseSyntax) **
Se la richiesta includeva `Marker`, la risposta restituisce tale valore in questo campo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **
Restituisce i target di montaggio del file system sotto forma di matrice di oggetti `MountTargetDescription`.
Tipo: matrice di oggetti [MountTargetDescription](API_MountTargetDescription.md)
** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **
Se è presente un valore, vi sono più tag di montaggio da restituire. In una richiesta successiva, puoi fornire `Marker` nella richiesta con questo valore per recuperare il prossimo set di target di montaggio.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
## Errori
** AccessPointNotFound **
Restituito se il `AccessPointId` valore specificato non esiste nel 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
** 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 in quello 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
** 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
** MountTargetNotFound **
Restituito se non è presente alcun target di montaggio con l'ID specificato trovato nell' Account AWS del chiamante.
** 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
## Esempi
### Recupero delle descrizioni dei target di montaggio creati per un file system
La richiesta seguente recupera le descrizioni dei target di montaggio creati per il file system specificato.
#### Richiesta di esempio
```
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357
{
"MountTargets":[
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-01234567",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"LifeCycleState":"added",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
}
]
}
```
## 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/DescribeMountTargets)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
# DescribeMountTargetSecurityGroups
Restituisce i gruppi di sicurezza attualmente attivi per un target di montaggio. Questa operazione richiede che l'interfaccia di rete del target di montaggio sia stata creata e lo stato del ciclo di vita del target di montaggio non sia `deleted`.
Questa operazione richiede autorizzazioni per le seguenti azioni:
+ Azione `elasticfilesystem:DescribeMountTargetSecurityGroups` sul file system del target di montaggio.
+ Azione `ec2:DescribeNetworkInterfaceAttribute` sull'interfaccia di rete del target di montaggio.
## Sintassi della richiesta
```
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **
L'ID del target di montaggio di cui vuoi recuperare i gruppi di sicurezza.
Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.
Modello: `^fsmt-[0-9a-f]{8,40}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"SecurityGroups": [ "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.
** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) **
Un array di gruppi di sicurezza.
Tipo: array di stringhe
Membri della matrice: numero massimo di 100 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 11. La lunghezza massima è 43 caratteri.
Modello: `^sg-[0-9a-f]{8,40}`
## Errori
** 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
** IncorrectMountTargetState **
Restituito se il target di montaggio non è nello stato corretto per l'operazione.
** 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
** MountTargetNotFound **
Restituito se non è presente alcun target di montaggio con l'ID specificato trovato nell' Account AWS del chiamante.
** 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
## Esempi
### Recupero dei gruppi di sicurezza in vigore per un file system
L'esempio seguente recupera i gruppi di sicurezza in vigore per l'interfaccia di rete associata a un target di montaggio.
#### Richiesta di esempio
```
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223513Z
Authorization: <...>
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
## 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/DescribeMountTargetSecurityGroups)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
# DescribeReplicationConfigurations
Recupera la configurazione di replica per un file system specifico. Se non viene specificato un file system, Regione AWS vengono recuperate tutte le configurazioni di replica per l' Account AWS in an.
## Sintassi della richiesta
```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **
È possibile recuperare la configurazione di replica per un file system specifico fornendo il relativo ID del file system. Per la replica tra account e regioni, un account può solo descrivere la configurazione di replica per un file system nella propria regione.
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})$`
** [MaxResults](#API_DescribeReplicationConfigurations_RequestSyntax) **
(Facoltativo) Puoi specificare il parametro `MaxItems` per limitare il numero di oggetti restituiti in una risposta. Il valore predefinito è 100.
Intervallo valido: valore minimo di 1.
** [NextToken](#API_DescribeReplicationConfigurations_RequestSyntax) **
`NextToken` è presente se la risposta è impaginata. È possibile utilizzare `NextToken` in una richiesta successiva per recuperare la pagina successiva di output.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Replications": [
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "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.
** [NextToken](#API_DescribeReplicationConfigurations_ResponseSyntax) **
È possibile utilizzare `NextToken` da una richiesta precedente in una richiesta successiva per recuperare ulteriori descrizioni.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) **
La raccolta di configurazioni di replica restituita.
Tipo: matrice di oggetti [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md)
## Errori
** 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 in quello 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
** 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
** ReplicationNotFound **
Restituito se il file system specificato non dispone di una configurazione di replica.
** ErrorCode **
ReplicationNotFound
** 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
** ValidationException **
Restituito se il AWS Backup servizio non è disponibile nel paese Regione AWS in cui è stata effettuata la 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: 400
## 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/DescribeReplicationConfigurations)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
# DescribeTags
**Nota**
OBSOLETO: l’azione `DescribeTags` è obsoleta e non viene mantenuta. Per visualizzare i tag associati alle risorse EFS, utilizza l'azione `ListTagsForResource` API.
Restituisce i tag associati a un file system. L'ordine dei tag restituiti nella risposta di una chiamata `DescribeTags` e l'ordine dei tag restituiti nelle risposte di un'iterazione a più chiamate (quando si utilizza l'impaginazione) non sono specificati.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DescribeTags`.
## Sintassi della richiesta
```
GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_DescribeTags_RequestSyntax) **
L'ID del file system da cui si desidera recuperare il set di tag.
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ì
** [Marker](#API_DescribeTags_RequestSyntax) **
(Facoltativo) Un token di impaginazione opaco restituito dalla precedente operazione `DescribeTags` (String). Se presente, specifica di continuare l'elenco dal punto in cui era stata interrotta la chiamata precedente.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [MaxItems](#API_DescribeTags_RequestSyntax) **
(Facoltativo) Il numero massimo di tag del file system da restituire nella risposta. Attualmente, questo numero viene impostato automaticamente su 100 e gli altri valori vengono ignorati. La risposta viene impaginata a 100 per pagina se sono presenti più di 100 tag.
Intervallo valido: valore minimo di 1.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"NextMarker": "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.
** [Marker](#API_DescribeTags_ResponseSyntax) **
Se la richiesta includeva `Marker`, la risposta restituisce tale valore in questo campo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [NextMarker](#API_DescribeTags_ResponseSyntax) **
Se è presente un valore, vi sono più tag da restituire. In una richiesta successiva, puoi fornire il valore di `NextMarker` come valore del parametro `Marker` nella richiesta successiva per recuperare il prossimo set di tag.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [Tags](#API_DescribeTags_ResponseSyntax) **
Restituisce i tag associati al file system come una serie di oggetti `Tag`.
Tipo: matrice di oggetti [Tag](API_Tag.md)
## Errori
** 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 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
** 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
## Esempi
### Recupero dei tag associati a un file system
La richiesta seguente recupera i tag (coppie chiave-valore) associati al file system specificato.
#### Richiesta di esempio
```
GET /2015-02-01/tags/fs-01234567/ HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215404Z
Authorization: <...>
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 288
{
"Tags":[
{
"Key":"Name",
"Value":"my first file system"
},
{
"Key":"Fleet",
"Value":"Development"
},
{
"Key":"Developer",
"Value":"Alice"
}
]
}
```
## 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/DescribeTags)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags)
# ListTagsForResource
Elenca tutti i tag di una risorsa EFS di primo livello. È necessario fornire l'ID della risorsa di cui si desidera recuperare i tag.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:DescribeAccessPoints`.
## Sintassi della richiesta
```
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListTagsForResource_RequestSyntax) **
(Facoltativo) Specifica il numero massimo di oggetti tag da restituire nella risposta. Il valore predefinito è 100.
Intervallo valido: valore minimo di 1.
** [NextToken](#API_ListTagsForResource_RequestSyntax) **
(Opzionale) Si può usare `NextToken` in una richiesta successiva per recuperare la pagina successiva delle descrizioni dei punti di accesso se il payload della risposta è stato impaginato.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [ResourceId](#API_ListTagsForResource_RequestSyntax) **
Specifica la risorsa EFS per la quale si desidera recuperare i tag. È possibile recuperare i tag per i file system EFS e i punti di accesso utilizzando questo endpoint API.
Limitazioni di lunghezza: lunghezza massima di 128.
Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "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.
** [NextToken](#API_ListTagsForResource_ResponseSyntax) **
`NextToken` è presente se il payload di risposta è impaginato. È possibile utilizzare `NextToken` in una richiesta successiva per recuperare la pagina successiva di descrizioni dei punti di accesso.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `.+`
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
Un array di tag per la risorsa EFS specificata.
Tipo: matrice di oggetti [Tag](API_Tag.md)
## Errori
** AccessPointNotFound **
Restituito se il `AccessPointId` valore specificato non esiste nel 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
** 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 in quello 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
** 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
## 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/ListTagsForResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource)
# ModifyMountTargetSecurityGroups
Modifica il set di gruppi di sicurezza attivi per un target di montaggio.
Quando crei un target di montaggio, Amazon EFS crea anche una nuova interfaccia di rete. Per ulteriori informazioni, consulta [CreateMountTarget](API_CreateMountTarget.md). Questa operazione sostituisce i gruppi di sicurezza in vigore per l'interfaccia di rete associata a un target di montaggio con i `SecurityGroups` forniti nella richiesta. Questa operazione richiede che l'interfaccia di rete del target di montaggio sia stata creata e lo stato del ciclo di vita del target di montaggio non sia `deleted`.
Questa operazione richiede autorizzazioni per le seguenti azioni:
+ Azione `elasticfilesystem:ModifyMountTargetSecurityGroups` sul file system del target di montaggio.
+ Azione `ec2:ModifyNetworkInterfaceAttribute` sull'interfaccia di rete del target di montaggio.
## Sintassi della richiesta
```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
L'ID del target di montaggio di cui si desidera modificare i gruppi di sicurezza.
Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.
Modello: `^fsmt-[0-9a-f]{8,40}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
Una serie di gruppi di sicurezza VPC. IDs
Tipo: array di stringhe
Membri della matrice: numero massimo di 100 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 11. La lunghezza massima è 43 caratteri.
Modello: `^sg-[0-9a-f]{8,40}`
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
** 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
** IncorrectMountTargetState **
Restituito se il target di montaggio non è nello stato corretto per l'operazione.
** 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
** MountTargetNotFound **
Restituito se non è presente alcun target di montaggio con l'ID specificato trovato nell' Account AWS del chiamante.
** 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
** SecurityGroupLimitExceeded **
Restituito se il numero `SecurityGroups` specificato nella richiesta è maggiore del limite, che si basa sulla quota dell'account. Elimina alcuni gruppi di sicurezza o richiedi l'aumento della quota dell'account. **Per ulteriori informazioni, consulta [Amazon VPC Quotas nella Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) *User Guide* (consulta la tabella dei gruppi di sicurezza).**
** 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
** SecurityGroupNotFound **
Restituito se uno dei gruppi di sicurezza specificati non esiste nel cloud privato virtuale (VPC) della sottorete.
** 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
## Esempi
### Sostituzione dei gruppi di sicurezza di un target di montaggio
L'esempio seguente sostituisce i gruppi di sicurezza in vigore per l'interfaccia di rete associata a un target di montaggio.
#### Richiesta di esempio
```
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
#### Risposta di esempio
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
# PutAccountPreferences
Utilizzate questa operazione per impostare la preferenza dell'account corrente Regione AWS per utilizzare la risorsa lunga da 17 caratteri (63 bit) o corta da 8 caratteri (32 bit) IDs per il nuovo file system EFS e montare le risorse di destinazione. Tutte le risorse esistenti non IDs sono influenzate dalle modifiche apportate. È possibile impostare la preferenza ID durante il periodo di attivazione quando EFS passa a una risorsa lunga. IDs Per ulteriori informazioni, consulta [Managing Amazon EFS resource IDs](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html).
**Nota**
A partire da ottobre 2021, riceverai un errore se tenti di impostare la preferenza dell'account per utilizzare l'ID di risorsa in formato breve a 8 caratteri. Contatta l' AWS assistenza se ricevi un errore e devi usare l'abbreviazione IDs di file system e mount delle risorse target.
## Sintassi della richiesta
```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **
Specifica la preferenza dell'ID di risorsa EFS da impostare per l'utente Account AWS Regione AWS, nella versione corrente, `LONG_ID` (17 caratteri) o `SHORT_ID` (8 caratteri).
A partire da ottobre 2021, riceverai un errore quando imposti la preferenza dell'account su `SHORT_ID`. Contatta l' AWS assistenza se ricevi un errore e devi usare l'abbreviazione IDs per file system e mount delle risorse di destinazione.
Tipo: String
Valori validi: `LONG_ID | SHORT_ID`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "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.
** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) **
Descrive il tipo di risorsa e la relativa preferenza ID per l'utente Account AWS, nella versione corrente Regione AWS.
Tipo: oggetto [ResourceIdPreference](API_ResourceIdPreference.md)
## Errori
** 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
** 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
## 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/PutAccountPreferences)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
# PutBackupPolicy
Aggiorna la policy di backup del file system. Utilizza questa azione per avviare o interrompere i backup automatici del file system.
## Sintassi della richiesta
```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **
Specifica per quale file system EFS aggiornare la policy di backup.
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ì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **
La policy di backup inclusa nella richiesta `PutBackupPolicy`.
Tipo: oggetto [BackupPolicy](API_BackupPolicy.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "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.
** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) **
Descrive la policy di backup del file system, indicando se i backup automatici sono attivati o disattivati.
Tipo: oggetto [BackupPolicy](API_BackupPolicy.md)
## Errori
** 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 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
** ValidationException **
Restituito se il AWS Backup servizio non è disponibile nel paese Regione AWS in cui è stata effettuata la 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: 400
## 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/PutBackupPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
# PutFileSystemPolicy
Applica un `FileSystemPolicy` Amazon EFS a un file system Amazon EFS. Una policy di file system è una policy basata su risorse IAM e può contenere più istruzioni di policy. Un file system contiene sempre esattamente una policy del file system, che può essere la policy predefinita o una policy esplicita impostata o aggiornata utilizzando questa operazione API. Le policy del file system EFS hanno un limite di 20.000 caratteri. Quando viene impostata una policy esplicita, questa sostituisce la policy predefinita. Per ulteriori informazioni sulla politica del file system predefinita, vedere Politica [del file system EFS predefinita](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy).
**Nota**
Le policy del file system EFS hanno un limite di 20.000 caratteri.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:PutFileSystemPolicy`.
## Sintassi della richiesta
```
PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json
{
"BypassPolicyLockoutSafetyCheck": boolean,
"Policy": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) **
ID del file system EFS per il quale si desidera creare o aggiornare `FileSystemPolicy`.
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ì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) **
(Facoltativo) Un valore booleano che specifica se ignorare o meno il controllo di sicurezza del blocco della `FileSystemPolicy`. Il controllo di sicurezza del blocco determina se la policy nella richiesta bloccherà, o impedirà, al principal IAM che sta effettuando la richiesta di fare richieste `PutFileSystemPolicy` future su questo file system. Imposta `BypassPolicyLockoutSafetyCheck` su `True` solo quando intendi impedire al principal IAM che sta effettuando la richiesta di effettuare richieste `PutFileSystemPolicy` successive su questo file system. Il valore predefinito è `False`.
Tipo: Booleano
Obbligatorio: no
** [Policy](#API_PutFileSystemPolicy_RequestSyntax) **
`FileSystemPolicy` in fase di creazione. Accetta una definizione di policy in formato JSON. Le policy del file system EFS hanno un limite di 20.000 caratteri. Per ulteriori informazioni sugli elementi che costituiscono una policy del file system, consulta Policy [basate sulle risorse all'interno di Amazon](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies) EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 20000 caratteri.
Modello: `[\s\S]+`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "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.
** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) **
Specifica il file system EFS a cui `FileSystemPolicy` si applica.
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})$`
** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) **
`FileSystemPolicy` formattato JSON per il file system EFS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 20000 caratteri.
Modello: `[\s\S]+`
## Errori
** 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 in quello 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
** InvalidPolicyException **
Restituito se `FileSystemPolicy` non è valido o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante. Restituito in caso di errore di controllo di sicurezza relativo al blocco delle policy.
** 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
## Esempi
### Crea un EFS FileSystemPolicy
La seguente richiesta crea un file system EFS `FileSystemPolicy` che consente a tutti AWS i principali di montare il file system EFS specificato con autorizzazioni di lettura e scrittura.
#### Richiesta di esempio
```
PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
}
]
}
```
#### Risposta di esempio
```
{
"Version": "2012-10-17",
"Id": "1",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
"Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567"
}
]
}
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
# PutLifecycleConfiguration
Utilizza questa azione per gestire lo storage per il file system. `LifecycleConfiguration` è costituito da uno o più oggetti `LifecyclePolicy` che definiscono quanto segue:
+ ** `TransitionToIA` **: quando spostare i file nel file system dalla classe di storage principale (classe di storage Standard) alla classe di storage Infrequent Access (IA).
+ ** `TransitionToArchive` **: quando spostare i file nel file system dalla classe di storage corrente (storage IA o Standard) allo storage di archivio.
I file system non possono passare allo storage di archivio prima di passare allo storage IA. Pertanto, non TransitionToArchive deve essere impostato o deve essere successivo a TransitionTo IA.
**Nota**
La classe di archiviazione Archive è disponibile solo per i file system che utilizzano la modalità Elastic throughput e la modalità di prestazioni General Purpose.
+ ** `TransitionToPrimaryStorageClass` **: quando spostare i file nel file system sullo storage principale (classe di storage Standard) dopo avervi effettuato l'accesso nello storage IA o di archivio.
Per ulteriori informazioni, consulta [Gestione dello storage del file system](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
Ogni file system Amazon EFS supporta una configurazione del ciclo di vita, che si applica a tutti i file del file system. Se esiste già un oggetto `LifecycleConfiguration` per il file system specificato, una chiamata `PutLifecycleConfiguration` modifica la configurazione esistente. Una chiamata `PutLifecycleConfiguration` con un array `LifecyclePolicies` vuoto nel corpo della richiesta elimina qualsiasi `LifecycleConfiguration` esistente. Nella richiesta, specifica quanto segue:
+ L'ID del file system per il quale state abilitando, disabilitando o modificando la gestione del ciclo di vita.
+ Una matrice `LifecyclePolicies` di oggetti `LifecyclePolicy` che definiscono quando spostare i file nello storage IA, nello storage di archivio e nuovamente nello storage principale.
**Nota**
Amazon EFS richiede che ogni oggetto `LifecyclePolicy` abbia una sola transizione, quindi la matrice `LifecyclePolicies` deve essere strutturata con oggetti `LifecyclePolicy` separati. Per ulteriori informazioni, consulta le richieste di esempio nelle sezioni seguenti.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:PutLifecycleConfiguration`.
Per applicare un `LifecycleConfiguration` oggetto a un file system crittografato, sono necessarie le stesse AWS Key Management Service autorizzazioni di quando è stato creato il file system crittografato.
## Sintassi della richiesta
```
PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **
L'ID del file system per il quale stai creando l'oggetto `LifecycleConfiguration` (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})$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **
Una matrice di oggetti `LifecyclePolicy` che definiscono l'oggetto `LifecycleConfiguration` del file system. Un `LifecycleConfiguration` oggetto fornisce alla gestione del ciclo di vita quanto segue:
+ ** `TransitionToIA` **: quando spostare i file nel file system dalla classe di storage principale (classe di storage Standard) alla classe di storage Infrequent Access (IA).
+ ** `TransitionToArchive` **: quando spostare i file nel file system dalla classe di storage corrente (storage IA o Standard) allo storage di archivio.
I file system non possono passare allo storage di archivio prima di passare allo storage IA. Pertanto, non TransitionToArchive deve essere impostato o deve essere successivo a IA. TransitionTo
**Nota**
La classe di archiviazione Archive è disponibile solo per i file system che utilizzano la modalità Elastic throughput e la modalità di prestazioni General Purpose.
+ ** `TransitionToPrimaryStorageClass` **: quando spostare i file nel file system sullo storage principale (classe di storage Standard) dopo avervi effettuato l'accesso nello storage IA o di archivio.
Quando si utilizza il comando `put-lifecycle-configuration` CLI o l'azione `PutLifecycleConfiguration` API, Amazon EFS richiede che ogni oggetto `LifecyclePolicy` abbia una sola transizione. Ciò significa che, nel corpo di una richiesta, `LifecyclePolicies` deve essere strutturato come una matrice di oggetti `LifecyclePolicy`, ossia un oggetto per ogni transizione di storage. Per ulteriori informazioni, consulta le richieste di esempio nelle sezioni seguenti.
Tipo: matrice di oggetti [LifecyclePolicy](API_LifecyclePolicy.md)
Membri della matrice: numero massimo di 3 elementi.
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "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.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) **
Una serie di policy di gestione del ciclo di vita. EFS supporta al massimo una policy per file system.
Tipo: matrice di oggetti [LifecyclePolicy](API_LifecyclePolicy.md)
Membri della matrice: numero massimo di 3 elementi.
## Errori
** 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
## Esempi
### Creazione di una configurazione del ciclo di vita
L'esempio seguente crea un oggetto `LifecyclePolicy` utilizzando l'azione `PutLifecycleConfiguration`. Questo esempio crea una policy del ciclo di vita che richiede a EFS di eseguire queste operazioni:
+ Spostare tutti i file del file system a cui non è stato effettuato l'accesso nello storage Standard negli ultimi 30 giorni nello storage IA.
+ Spostare tutti i file del file system a cui non è stato effettuato l'accesso nello storage Standard negli ultimi 90 giorni nello storage IA.
+ Riportare i file nello storage Standard dopo avervi effettuato l'accesso nello storage IA o di archivio. La classe di archiviazione Archive è disponibile solo per i file system che utilizzano la modalità di trasmissione elastica e la modalità di prestazioni General Purpose.
Per ulteriori informazioni, consulta [Classi di storage EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) e [Gestione dello storage del file system](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
#### Richiesta di esempio
```
PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
### Richiesta put-lifecycle-configuration CLI di esempio
Questo esempio illustra un utilizzo di. PutLifecycleConfiguration
#### Richiesta di esempio
```
aws efs put-lifecycle-configuration \
--file-system-id fs-0123456789abcdefb \
--lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
{"TransitionToIA":"AFTER_30_DAYS"},
{"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]
--region us-west-2 \
--profile adminuser
```
#### Risposta di esempio
```
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
### Disattivazione della gestione del ciclo di vita
L'esempio seguente disattiva la gestione del ciclo di vita per il file system specificato.
#### Richiesta di esempio
```
PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
## 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/PutLifecycleConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
# TagResource
Crea un tag per una risorsa EFS. È possibile creare tag per i file system e i punti di accesso EFS utilizzando questa operazione API.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:TagResource`.
## Sintassi della richiesta
```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ResourceId](#API_TagResource_RequestSyntax) **
L'ID che specifica la risorsa EFS per la quale desideri creare un tag.
Limitazioni di lunghezza: lunghezza massima di 128.
Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Tags](#API_TagResource_RequestSyntax) **
Una matrice di oggetti `Tag` da aggiungere. Ogni oggetto `Tag` è una coppia chiave-valore.
Tipo: matrice di oggetti [Tag](API_Tag.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
** AccessPointNotFound **
Restituito se il `AccessPointId` valore specificato non esiste nel 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
** 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 in quello 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
** 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
## Esempi
### Creazione di tag su un file system
La richiesta seguente crea tre tag (`"key1"`, `"key2"` e `"key3"`) nel file system specificato.
#### Richiesta di esempio
```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
#### Risposta di esempio
```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/TagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)
# UntagResource
Rimuove i tag da una risorsa EFS. È possibile rimuovere tag per i file system e i punti di accesso EFS utilizzando questa operazione API.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:UntagResource`.
## Sintassi della richiesta
```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ResourceId](#API_UntagResource_RequestSyntax) **
Specifica la risorsa EFS da cui si desidera rimuovere i tag.
Limitazioni di lunghezza: lunghezza massima di 128.
Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Obbligatorio: sì
** [TagKeys](#API_UntagResource_RequestSyntax) **
Le chiavi delle coppie chiave-valore associate ai tag da rimuovere dalla risorsa EFS specificata.
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
** AccessPointNotFound **
Restituito se il `AccessPointId` valore specificato non esiste nel 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
** 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 in quello 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
** 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
## 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/UntagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource)
# UpdateFileSystem
Aggiorna la modalità di throughput o la quantità di throughput assegnato di un file system esistente.
## Sintassi della richiesta
```
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number,
"ThroughputMode": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) **
L'ID del file system che si desidera aggiornare.
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ì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) **
(Facoltativo) La velocità effettiva, misurata in mebibyte al secondo (MiBps), che desideri fornire per un file system che stai creando. Obbligatorio se `ThroughputMode` è impostato su `provisioned`. I valori validi sono 1-3414 MiBps, con il limite superiore a seconda della regione. Per aumentare questo limite, contatta. Supporto Per ulteriori informazioni, consulta [Quote di Amazon EFS che è possibile incrementare](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) nella *Guida per l'utente di Amazon EFS*.
Tipo: numero a doppia precisione
Intervallo valido: valore minimo di 1.0.
Obbligatorio: no
** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) **
(Facoltativo) Aggiorna la modalità di trasmissione del file system. Se non state aggiornando la modalità di throughput, non è necessario fornire questo valore nella richiesta. Se `ThroughputMode` è impostato su `provisioned`, è necessario impostare anche un valore per `ProvisionedThroughputInMibps`.
Tipo: String
Valori validi: `bursting | provisioned | elastic`
Campo obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 202
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 202.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AvailabilityZoneId](#API_UpdateFileSystem_ResponseSyntax) **
L'identificatore univoco e coerente della zona di disponibilità in cui si trova il file system, valido solo per i file system a zona singola. Ad esempio, `use1-az1` è un ID della zona di disponibilità per Regione AWS us-east-1 e ha la stessa posizione in tutti. Account AWS
Tipo: String
** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) **
Descrive la zona di AWS disponibilità in cui si trova il file system ed è valido solo per i file system a zona singola. Per ulteriori informazioni, consulta [Utilizzo delle classi di archiviazione EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) nella *Guida per l'utente di Amazon EFS*.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) **
L'ora di creazione del file system, in secondi (da 1970-01-01T00:00:00Z).
Tipo: Timestamp
** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) **
Stringa opaca specificata nella richiesta.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello: `.+`
** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) **
Valore booleano che, se "true", indica che il file system è crittografato.
Tipo: Booleano
** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) per il file system Amazon EFS in formato `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Esempio con dati campione: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Tipo: String
** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) **
L'ID del file system, assegnato da Amazon EFS.
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})$`
** [FileSystemProtection](#API_UpdateFileSystem_ResponseSyntax) **
Descrive la protezione del file system.
Tipo: oggetto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) **
L'ID di un file AWS KMS key utilizzato per proteggere il file system crittografato.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 2048.
Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_UpdateFileSystem_ResponseSyntax) **
La fase del ciclo di vita del file system.
Tipo: String
Valori validi: `creating | available | updating | deleting | deleted | error`
** [Name](#API_UpdateFileSystem_ResponseSyntax) **
È possibile aggiungere tag a un file system, incluso un tag `Name`. Per ulteriori informazioni, consulta [CreateFileSystem](API_CreateFileSystem.md). Se il file system ha un tag `Name`, Amazon EFS restituisce il valore in questo campo.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 256.
Modello: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) **
Il numero attuale di target di montaggio del file system. Per ulteriori informazioni, consulta [CreateMountTarget](API_CreateMountTarget.md).
Tipo: numero intero
Intervallo valido: valore minimo di 0.
** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) **
Quello Account AWS che ha creato il file system.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 14.
Modello: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) **
Le modalità di prestazioni dei file system.
Tipo: String
Valori validi: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) **
La quantità di velocità effettiva assegnata, misurata in MiBps, per il file system. Valido per i file system che utilizzano `ThroughputMode` impostato su `provisioned`.
Tipo: numero a doppia precisione
Intervallo valido: valore minimo di 1.0.
** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) **
L'ultima dimensione misurata nota (in byte) dei dati memorizzati nel file system, nel relativo campo `Value` e l'ora in cui tale dimensione è stata determinata nel campo `Timestamp`. Il valore `Timestamp` è il numero intero di secondi dal 1970-01-01T00:00:00Z. Il valore `SizeInBytes` non rappresenta la dimensione di un'istantanea coerente del file system, ma è coerente quando non vi sono operazioni di scrittura sul file system. Ossia, `SizeInBytes` rappresenta la dimensione effettiva solo se il file system non viene modificato per un periodo superiore a un paio d'ore. Altrimenti, il valore non corrisponde alla dimensione esatta che aveva il file system in qualsiasi momento.
Tipo: oggetto [FileSystemSize](API_FileSystemSize.md)
** [Tags](#API_UpdateFileSystem_ResponseSyntax) **
I tag associati al file system, presentati come una serie di oggetti `Tag`.
Tipo: matrice di oggetti [Tag](API_Tag.md)
** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) **
Visualizza la modalità di throughput per un file system. Per ulteriori informazioni, consulta [Modalità di throughput](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) nella *Guida per l'utente di Amazon EFS*.
Tipo: String
Valori validi: `bursting | provisioned | elastic`
## Errori
** 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
** InsufficientThroughputCapacity **
Restituito se la capacità non è sufficiente per fornire un throughput aggiuntivo. Questo valore può essere restituito quando si tenta di creare un file system in modalità di throughput assegnato, quando si tenta di aumentare la velocità di trasmissione effettiva assegnata di un file system esistente o quando si tenta di modificare un file system esistente dalla modalità Bursting alla modalità Con provisioning. Riprova più tardi.
** 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: 503
** 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
** ThroughputLimitExceeded **
Restituito se la modalità di throughput o la quantità di throughput assegnata non possono essere modificate perché è stato raggiunto il limite di throughput di 1024. MiB/s
** 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
** TooManyRequests **
Restituito se non si attendono almeno 24 ore prima di modificare la modalità di throughput o di ridurre il valore del Provisioned Throughput.
** 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 AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
# UpdateFileSystemProtection
Aggiorna la protezione del file system.
Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:UpdateFileSystemProtection`.
## Sintassi della richiesta
```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **
L'ID del file system che si desidera aggiornare.
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ì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **
Lo stato della replica del file system sovrascrive la protezione.
+ `ENABLED` - Non è possibile utilizzare un file system come file system di destinazione in un'altra configurazione di replica. Il file system è scrivibile. La protezione da sovrascrittura della replica è `ENABLED` per impostazione predefinita.
+ `DISABLED` - È possibile utilizzare un file system come file system di destinazione in una configurazione di replica. Il file system è di sola lettura e viene modificato solo dalla replica EFS.
+ `REPLICATING`: il file system è in uso come file system di destinazione in una configurazione di replica. Il file system è di sola lettura e viene modificato solo dalla replica EFS.
Se la configurazione di replica viene eliminata, la protezione da sovrascrittura della replica del file system viene riattivata e il file system diventa scrivibile.
Tipo: String
Valori validi: `ENABLED | DISABLED | REPLICATING`
Campo obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "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.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) **
Lo stato della replica del file system sovrascrive la protezione.
+ `ENABLED` - Non è possibile utilizzare un file system come file system di destinazione in un'altra configurazione di replica. Il file system è scrivibile. La protezione da sovrascrittura della replica è `ENABLED` per impostazione predefinita.
+ `DISABLED` - È possibile utilizzare un file system come file system di destinazione in una configurazione di replica. Il file system è di sola lettura e viene modificato solo dalla replica EFS.
+ `REPLICATING`: il file system è in uso come file system di destinazione in una configurazione di replica. Il file system è di sola lettura e viene modificato solo dalla replica EFS.
Se si elimina la configurazione di replica, la protezione da sovrascrittura del file system viene riattivata e il file system diventa scrivibile.
Tipo: String
Valori validi: `ENABLED | DISABLED | REPLICATING`
## Errori
** 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 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
** InsufficientThroughputCapacity **
Restituito se la capacità non è sufficiente per fornire un throughput aggiuntivo. Questo valore può essere restituito quando si tenta di creare un file system in modalità di throughput assegnato, quando si tenta di aumentare la velocità di trasmissione effettiva assegnata di un file system esistente o quando si tenta di modificare un file system esistente dalla modalità Bursting alla modalità Con provisioning. Riprova più tardi.
** 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: 503
** 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
** ReplicationAlreadyExists **
Restituito se il file system è già incluso in una configurazione di replica.
** 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
** ThroughputLimitExceeded **
Restituito se la modalità di throughput o la quantità di throughput assegnata non possono essere modificate perché è stato raggiunto il limite di throughput di 1024. MiB/s
** 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
** TooManyRequests **
Restituito se non si attendono almeno 24 ore prima di modificare la modalità di throughput o di ridurre il valore del Provisioned Throughput.
** 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 AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)