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