DescribeLocationFsxWindows - AWS DataSync
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

DescribeLocationFsxWindows

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento FSx per un file system Amazon for Windows File Server.

Sintassi della richiesta

{
   "LocationArn": "string"
}

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

LocationArn

Speciifica l'Amazon Resource Name (ARN) della posizione FSx del file server per Windows.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^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}$

Obbligatorio: sì

Sintassi della risposta

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

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.

CmkSecretConfig

Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un segreto DataSync utilizzato per accedere a una Password posizione di archiviazione specifica, con un segreto gestito dal cliente. AWS KMS key

Tipo: oggetto CmkSecretConfig

CreationTime

L'ora in cui è stata creata la posizione FSx per Windows File Server.

Tipo: Timestamp

CustomSecretConfig

Descrive le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un Password segreto DataSync utilizzato per accedere a una posizione di archiviazione specifica, con un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.

Tipo: oggetto CustomSecretConfig

Domain

Il nome del dominio Microsoft Active Directory a cui appartiene il file system FSx for Windows File Server.

Tipo: String

Vincoli di lunghezza: lunghezza massima di 253.

Modello: ^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$

LocationArn

L'ARN della posizione del file server FSx per Windows.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^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'Uniform Resource Identifier (URI) della posizione FSx per Windows File Server.

Tipo: String

Vincoli di lunghezza: lunghezza massima di 4360.

Modello: ^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$

ManagedSecretConfig

Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un segreto DataSync utilizzato per accedere a una Password posizione di archiviazione specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS

Tipo: oggetto ManagedSecretConfig

SecurityGroupArns

Gli ARN dei gruppi di sicurezza di Amazon EC2 che forniscono l'accesso alla sottorete preferita del file system.

Per informazioni sulla configurazione dei gruppi di sicurezza per l'accesso al file system, consulta la Amazon FSx for Windows File Server User Guide.

Tipo: array di stringhe

Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi.

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^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

L'utente con le autorizzazioni per montare e accedere al file system FSx per Windows File Server.

Tipo: String

Vincoli di lunghezza: lunghezza massima di 104.

Modello: ^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalException

Questa eccezione viene generata quando si verifica un errore nel servizio. AWS DataSync

Codice di stato HTTP: 500

InvalidRequestException

Questa eccezione viene generata quando il client invia una richiesta non valida.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: