Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
DescribeLocationFsxWindows
Proporciona detalles sobre cómo se configura una ubicación de AWS DataSync transferencia para un sistema de archivos de Amazon FSx para Windows File Server.
Sintaxis de la solicitud
{
"LocationArn": "string"
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- LocationArn
-
Especifica el nombre de recurso de Amazon (ARN) de la ubicación del servidor FSx de archivos de Windows.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^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}$Obligatorio: sí
Sintaxis de la respuesta
{
"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"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- CmkSecretConfig
-
Describe la información de configuración de un secreto DataSync administrado, como el
Passwordque se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con un secreto administrado por el cliente. AWS KMS keyTipo: objeto CmkSecretConfig
- CreationTime
-
La hora a la que se creó la FSx ubicación del servidor de archivos de Windows.
Tipo: marca temporal
- CustomSecretConfig
-
Describe la información de configuración de un secreto administrado por el cliente, como el
Passwordque se DataSync utiliza para acceder a una ubicación de almacenamiento específica, con una función administrada por el cliente AWS Identity and Access Management (IAM) que proporciona acceso al secreto.Tipo: objeto CustomSecretConfig
- Domain
-
El nombre del dominio de Microsoft Active Directory al que pertenece el sistema FSx de archivos del servidor de archivos de Windows.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 253 caracteres.
Patrón:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$ - LocationArn
-
El ARN de la ubicación del servidor FSx de archivos de Windows.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^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
-
El identificador uniforme de recursos (URI) de la ubicación del servidor FSx de archivos de Windows.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 4360 caracteres.
Patrón:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - ManagedSecretConfig
-
Describe la información de configuración de un secreto DataSync administrado, como el
Passwordque se DataSync utiliza para acceder a una ubicación de almacenamiento específica. DataSync utiliza la clave KMS AWS administrada por defecto para cifrar este secreto. AWS Secrets ManagerTipo: objeto ManagedSecretConfig
- SecurityGroupArns
-
Los ARN de los grupos de seguridad de Amazon EC2 que proporcionan acceso a la subred preferida del sistema de archivos.
Para obtener información sobre la configuración de grupos de seguridad para el acceso al sistema de archivos, consulte la Guía del usuario de Amazon FSx for Windows File Server.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^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
-
El usuario con los permisos para montar y acceder al sistema de archivos del servidor de archivos de Windows. FSx
Tipo: cadena
Limitaciones de longitud: longitud máxima de 104 caracteres.
Patrón:
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InternalException
-
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
