PutFileSystemPolicy - Amazon Elastic File System
Syntaxe de la requêteURIParamètres de demandeCorps de la demandeSyntaxe de la réponseEléments de réponseErreursExemplesconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

PutFileSystemPolicy

Applique un Amazon EFS FileSystemPolicy à un système de EFS fichiers Amazon. Une politique de système de fichiers est une stratégie IAM basée sur les ressources et peut contenir plusieurs déclarations de politique. Un système de fichiers possède toujours exactement une politique de système de fichiers, qui peut être la stratégie par défaut ou une politique explicite définie ou mise à jour à l'aide de cette API opération. EFSles politiques du système de fichiers sont limitées à 20 000 caractères. Lorsqu’une politique explicite est définie, elle remplace la stratégie par défaut. Pour plus d'informations sur la stratégie de système de fichiers par défaut, consultez la section Stratégie de système de EFS fichiers par défaut.

Note

EFSles politiques du système de fichiers sont limitées à 20 000 caractères.

Cette opération exige des autorisations pour l’action elasticfilesystem:PutFileSystemPolicy.

Syntaxe de la requête

PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json

{
   "BypassPolicyLockoutSafetyCheck": boolean,
   "Policy": "string"
}

URIParamètres de demande

La demande utilise les URI paramètres suivants.

FileSystemId

ID du système de EFS fichiers pour lequel vous souhaitez créer ou mettre FileSystemPolicy à jour.

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Obligatoire : oui

Corps de la demande

La demande accepte les données suivantes au JSON format suivant.

BypassPolicyLockoutSafetyCheck

(Facultatif) Une valeur booléenne qui indique s’il faut ignorer ou non le contrôle de sécurité du verrouillage FileSystemPolicy. Le contrôle de sécurité du verrouillage détermine si la politique de la demande bloquera ou empêchera le IAM principal auteur de la demande de faire de futures PutFileSystemPolicy demandes sur ce système de fichiers. Définissez BypassPolicyLockoutSafetyCheck cette True valeur uniquement lorsque vous souhaitez empêcher le IAM principal à l'origine de la demande de faire des PutFileSystemPolicy demandes ultérieures sur ce système de fichiers. La valeur par défaut est False.

Type : booléen

Obligatoire : non

Policy

La FileSystemPolicy que vous créez. Accepte une définition de politique JSON formatée. EFSles politiques du système de fichiers sont limitées à 20 000 caractères. Pour en savoir plus sur les éléments qui constituent une politique de système de fichiers, consultez la section Politiques basées sur les ressources au sein d'Amazon. EFS

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 20000.

Modèle : [\s\S]+

Obligatoire : oui

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "FileSystemId": "string",
   "Policy": "string"
}

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées sous JSON forme formatée par le service.

FileSystemId

Spécifie le système de EFS fichiers auquel FileSystemPolicy s'applique le.

Type : chaîne

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Policy

JSONFormaté FileSystemPolicy pour le système de EFS fichiers.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 20000.

Modèle : [\s\S]+

Erreurs

BadRequest

Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.

HTTPCode de statut : 400

FileSystemNotFound

Renvoyé si la FileSystemId valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.

HTTPCode de statut : 404

IncorrectFileSystemLifeCycleState

Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».

HTTPCode de statut : 409

InternalServerError

Renvoyé si une erreur s’est produite côté serveur.

HTTPCode de statut : 500

InvalidPolicyException

Renvoyé si le FileSystemPolicy est mal formé ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant. Renvoyé en cas d’erreur liée au contrôle de sécurité lié à la politique de verrouillage.

HTTPCode de statut : 400

Exemples

Créez un EFS FileSystemPolicy

La demande suivante crée un système FileSystemPolicy qui permet à tous les AWS principaux de monter le système de EFS fichiers spécifié avec des autorisations de lecture et d'écriture.

Exemple de demande

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": ["*"]
            },
        }
    ]
}

Exemple de réponse

{
    "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"
        }
    ]
}

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :