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
oFileSystemId
. 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
oAccessPointId
. 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 AWSHTTPCodice 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: