DescribeMountTargets - Amazon Elastic File System

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

DescribeMountTargets

Restituisce le descrizioni di tutti i target di montaggio correnti o un target di montaggio specifico, per un file system. Quando si richiedono tutti i target di montaggio correnti, l'ordine dei target di montaggio restituiti nella risposta non è specificato.

Questa operazione richiede le autorizzazioni per l'azione elasticfilesystem:DescribeMountTargets, sull'ID del file system specificato in FileSystemId o sul file system del target di montaggio specificato in MountTargetId.

Sintassi della richiesta

GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1

URIParametri della richiesta

La richiesta utilizza i seguenti URI parametri.

AccessPointId

(Facoltativo) L'ID del punto di accesso di cui desideri elencare i target di montaggio. Deve essere incluso nella richiesta se nella stessa non è incluso MountTargetId o FileSystemId. Accetta un ID del punto di accesso o ARN come input.

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

FileSystemId

(Facoltativo) ID del file system di cui desideri elencare i target di montaggio (String). Deve essere incluso nella richiesta se non è incluso MountTargetId o AccessPointId. Accetta un ID del file system o ARN come input.

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})$

Marker

(Facoltativo) Un token di impaginazione opaco restituito dalla precedente operazione DescribeMountTargets (String). Se presente, specifica di continuare l'elenco dal punto in cui era stata interrotta la chiamata precedente.

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: .+

MaxItems

(Facoltativo) Il numero massimo di target di montaggio da restituire nella risposta. Attualmente, questo numero viene impostato automaticamente su 10 e gli altri valori vengono ignorati. La risposta viene impaginata a 100 per pagina se si dispone di più di 100 target di montaggio.

Intervallo valido: valore minimo di 1.

MountTargetId

(Facoltativo) ID del target di montaggio da descrivere (String). Deve essere incluso nella richiesta se non è incluso FileSystemId. Accetta un ID di destinazione di montaggio o ARN come input.

Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.

Modello: ^fsmt-[0-9a-f]{8,40}$

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

HTTP/1.1 200 Content-type: application/json { "Marker": "string", "MountTargets": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "string" } ], "NextMarker": "string" }

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

Marker

Se la richiesta includeva Marker, la risposta restituisce tale valore in questo campo.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: .+

MountTargets

Restituisce i target di montaggio del file system sotto forma di matrice di oggetti MountTargetDescription.

Tipo: matrice di oggetti MountTargetDescription

NextMarker

Se è presente un valore, vi sono più tag di montaggio da restituire. In una richiesta successiva, puoi fornire Marker nella richiesta con questo valore per recuperare il prossimo set di target di montaggio.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: .+

Errori

AccessPointNotFound

Restituito se il AccessPointId valore specificato non esiste nel richiedente Account AWS.

HTTPCodice di stato: 404

BadRequest

Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.

HTTPCodice di stato: 400

FileSystemNotFound

Restituito se il FileSystemId valore specificato non esiste in quello del richiedente. Account AWS

HTTPCodice di stato: 404

InternalServerError

Restituito se si è verificato un errore lato server.

HTTPCodice di stato: 500

MountTargetNotFound

Restituito se non è presente alcun target di montaggio con l'ID specificato trovato nell' Account AWS del chiamante.

HTTPCodice di stato: 404

Esempi

Recupero delle descrizioni dei target di montaggio creati per un file system

La richiesta seguente recupera le descrizioni dei target di montaggio creati per il file system specificato.

Richiesta di esempio

GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191252Z Authorization: <...>

Risposta di esempio

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 357 { "MountTargets":[ { "OwnerId":"251839141158", "MountTargetId":"fsmt-01234567", "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "LifeCycleState":"added", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" } ] }

Vedi anche

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