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.
DescribeLocationFsxWindows
Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert FSx pour un système de fichiers Amazon pour Windows File Server.
Syntaxe de la requête
{
"LocationArn": "string"
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- LocationArn
-
Spécifie le nom de ressource Amazon (ARN) de l'emplacement du serveur de fichiers FSx pour Windows.
Type : Chaîne
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$Obligatoire : oui
Syntaxe de la réponse
{
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"CreationTime": number,
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"Domain": "string",
"LocationArn": "string",
"LocationUri": "string",
"ManagedSecretConfig": {
"SecretArn": "string"
},
"SecurityGroupArns": [ "string" ],
"User": "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 au format JSON par le service.
- CmkSecretConfig
-
Décrit les informations de configuration d'un secret DataSync géré, tel
Passwordqu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un secret géré par le client AWS KMS key.Type : objet CmkSecretConfig
- CreationTime
-
Heure à laquelle l'emplacement FSx du serveur de fichiers Windows a été créé.
Type : Timestamp
- CustomSecretConfig
-
Décrit les informations de configuration d'un secret géré par le client, tel
Passwordqu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique, avec un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui permet d'accéder au secret.Type : objet CustomSecretConfig
- Domain
-
Nom du domaine Microsoft Active Directory auquel appartient le système de fichiers FSx pour Windows File Server.
Type : Chaîne
Contraintes de longueur : longueur maximale de 253.
Modèle :
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$ - LocationArn
-
L'ARN de l'emplacement du serveur de fichiers FSx pour Windows.
Type : Chaîne
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$ - LocationUri
-
L'identifiant de ressource uniforme (URI) de FSx l'emplacement du serveur de fichiers Windows.
Type : Chaîne
Contraintes de longueur : longueur maximale de 4360.
Modèle :
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - ManagedSecretConfig
-
Décrit les informations de configuration d'un secret DataSync géré, tel
Passwordqu'un secret DataSync utilisé pour accéder à un emplacement de stockage spécifique. DataSync utilise la clé KMS AWS gérée par défaut pour chiffrer ce secret. AWS Secrets ManagerType : objet ManagedSecretConfig
- SecurityGroupArns
-
Les ARN des groupes de sécurité Amazon EC2 qui fournissent l'accès au sous-réseau préféré de votre système de fichiers.
Pour plus d'informations sur la configuration des groupes de sécurité pour l'accès au système de fichiers, consultez le guide de l'utilisateur du serveur de fichiers Amazon FSx pour Windows.
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments.
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$ - User
-
Utilisateur autorisé à monter et à accéder au système de fichiers FSx for Windows File Server.
Type : Chaîne
Contraintes de longueur : longueur maximale de 104.
Modèle :
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InternalException
-
Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service.
Code d’état HTTP : 500
- InvalidRequestException
-
Cette exception est levée lorsque le client soumet une demande mal formée.
Code d’état HTTP : 400
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
