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à.
CreateMountTarget
Crea un target di montaggio per un file system. È quindi possibile montare il file system sulle EC2 istanze utilizzando la destinazione di montaggio.
Puoi creare un target di montaggio in ogni zona di disponibilità del tuoVPC. Tutte le EC2 istanze all'VPCinterno di una determinata zona di disponibilità condividono un'unica destinazione di montaggio per un determinato file system. Se in una zona di disponibilità vi sono più sottoreti, è possibile creare un target di montaggio in una di tali sottoreti. EC2non è necessario che le istanze si trovino nella stessa sottorete della destinazione di montaggio per accedere al relativo file system.
È possibile creare un solo target di montaggio per un file system a zona singola. È necessario creare tale target di montaggio nella stessa zona di disponibilità in cui si trova il file system. Utilizzate le proprietà AvailabilityZoneName
e AvailabiltyZoneId
nell'oggetto DescribeFileSystems di risposta per ottenere queste informazioni. Utilizzate la zona di disponibilità subnetId
associata alla zona di disponibilità del file system durante la creazione del target di montaggio.
Per ulteriori informazioni, consulta AmazonEFS: How it Works.
Per creare un target di montaggio per un file system, lo stato del ciclo di vita del file system deve essere available
. Per ulteriori informazioni, consulta DescribeFileSystems.
Nella richiesta, specifica quanto segue:
-
L'ID del file system per il quale si sta creando il target di montaggio.
-
Un ID di sottorete, che determina quanto segue:
-
La destinazione VPC in cui Amazon EFS crea il target di montaggio
-
La zona di disponibilità in cui Amazon EFS crea il target di montaggio
-
L'intervallo di indirizzi IP da cui Amazon EFS seleziona l'indirizzo IP della destinazione di montaggio (se non specifichi un indirizzo IP nella richiesta)
-
Dopo aver creato il mount target, Amazon EFS restituisce una risposta che include, a MountTargetId
e anIpAddress
. Utilizzi questo indirizzo IP per montare il file system in un'EC2istanza. È inoltre possibile utilizzare il DNS nome della destinazione di montaggio durante il montaggio del file system. L'EC2istanza su cui si monta il file system utilizzando la destinazione di montaggio può risolvere il DNS nome della destinazione di montaggio nel relativo indirizzo IP. Per ulteriori informazioni, consulta Come funziona: riepilogo dell'implementazione.
Si noti che è possibile creare destinazioni di montaggio per un file system in una sola VPC destinazione e che può esserci una sola destinazione di montaggio per zona di disponibilità. Ciò significa che, se il file system dispone già di una o più target di montaggio create, la sottorete specificata nella richiesta di aggiunta di un'altra target di montaggio deve soddisfare i seguenti requisiti:
-
Deve appartenere alle VPC stesse sottoreti delle destinazioni di montaggio esistenti
-
Non deve trovarsi nella stessa zona di disponibilità delle sottoreti dei target di montaggio esistenti
Se la richiesta soddisfa i requisiti, Amazon EFS effettua le seguenti operazioni:
-
Crea un nuovo target di montaggio nella sottorete specificata.
-
Crea anche una nuova interfaccia di rete nella sottorete, come segue:
-
Se la richiesta fornisce un
IpAddress
, Amazon EFS assegna quell'indirizzo IP all'interfaccia di rete. Altrimenti, Amazon EFS assegna un indirizzo gratuito nella sottorete (nello stesso modo in cui avviene la EC2CreateNetworkInterface
chiamata Amazon quando una richiesta non specifica un indirizzo IP privato primario). -
Se la richiesta indica
SecurityGroups
, l'interfaccia di rete è associata a tali gruppi di sicurezza. Altrimenti, appartiene al gruppo di sicurezza predefinito per la sottorete. VPC -
Assegna la descrizione
Mount target fsmt-id for file system fs-id
in cuifsmt-id
è l'ID del target di montaggio efs-id
è ilFileSystemId
. -
Imposta la proprietà
requesterManaged
dell'interfaccia di rete sutrue
e il valorerequesterId
suEFS
.
Ogni destinazione di EFS montaggio Amazon ha un'interfaccia di EC2 rete gestita dal richiedente corrispondente. Dopo aver creato l'interfaccia di rete, Amazon EFS imposta il
NetworkInterfaceId
campo nella descrizione del target di montaggio sull'ID dell'interfaccia di rete e ilIpAddress
campo sul relativo indirizzo. Se la creazione dell'interfaccia di rete non riesce, l'intera operazioneCreateMountTarget
ha esito negativo. -
Nota
La chiamata CreateMountTarget
restituisce solo dopo aver creato l'interfaccia di rete ma, mentre il target di montaggio è ancora in stato creating
, è possibile controllarne lo stato di creazione chiamando l'operazione DescribeMountTargets che, tra l’altro, restituirà lo stato del target di montaggio.
È consigliabile creare un target di montaggio in ciascuna delle zone di disponibilità. L'utilizzo di un file system in una zona di disponibilità attraverso un target di montaggio creata in un'altra zona di disponibilità determina costi da tenere in considerazione. Per ulteriori informazioni, consulta Amazon EFS
Questa operazione richiede autorizzazioni per le seguenti operazioni sul file system:
-
elasticfilesystem:CreateMountTarget
Questa operazione richiede anche le autorizzazioni per le seguenti EC2 azioni Amazon:
-
ec2:DescribeSubnets
-
ec2:DescribeNetworkInterfaces
-
ec2:CreateNetworkInterface
Sintassi della richiesta
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string
",
"IpAddress": "string
",
"SecurityGroups": [ "string
" ],
"SubnetId": "string
"
}
URIParametri della richiesta
La richiesta non utilizza alcun URI parametro.
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- FileSystemId
-
L'ID del file system per il quale creare il target di montaggio.
▬Tipo: stringa
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})$
Campo obbligatorio: sì
- IpAddress
-
IPv4Indirizzo valido all'interno dell'intervallo di indirizzi della sottorete specificata.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 7. La lunghezza massima è 15 caratteri.
Modello:
^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
Campo obbligatorio: no
- SecurityGroups
-
Fino a cinque gruppi VPC di sicurezzaIDs, nel modulo
sg-xxxxxxxx
. Questi devono corrispondere alla sottorete specificata. VPCTipo: matrice di stringhe
Membri della matrice: numero massimo di 100 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 11. La lunghezza massima è 43 caratteri.
Modello:
^sg-[0-9a-f]{8,40}
Campo obbligatorio: no
- SubnetId
-
L'ID della sottorete in cui aggiungere il target di montaggio. Per i file system a zona singola, utilizza la sottorete associata alla zona di disponibilità del file system.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 15. La lunghezza massima è 47 caratteri.
Modello:
^subnet-[0-9a-f]{8,40}$
Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "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.
- AvailabilityZoneId
-
L'identificatore univoco e coerente della zona di disponibilità in cui risiede il target di montaggio. Ad esempio,
use1-az1
è un ID AZ per la regione us-east-1 e ha la stessa posizione in ogni. Account AWS▬Tipo: stringa
- AvailabilityZoneName
-
Il nome della zona di disponibilità in cui si trova il target di montaggio. Le zone di disponibilità sono mappate indipendentemente in base ai nomi di ciascuna. Account AWS Ad esempio, la zona
us-east-1a
di disponibilità dell'utente Account AWS potrebbe non corrispondere a quellaus-east-1a
di un'altra Account AWS.▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
.+
- FileSystemId
-
L'ID del file system per il quale creare il target di montaggio.
▬Tipo: stringa
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})$
- IpAddress
-
Indirizzo presso il quale è possibile montare il file system utilizzando il target di montaggio.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 7. La lunghezza massima è 15 caratteri.
Modello:
^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
- LifeCycleState
-
Stato del ciclo di vita del target di montaggio.
▬Tipo: stringa
Valori validi:
creating | available | updating | deleting | deleted | error
- MountTargetId
-
ID del target di montaggio assegnato dal sistema.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.
Modello:
^fsmt-[0-9a-f]{8,40}$
- NetworkInterfaceId
-
L'ID dell'interfaccia di rete che Amazon EFS ha creato al momento della creazione della destinazione di montaggio.
▬Tipo: stringa
- OwnerId
-
Account AWS ID che possiede la risorsa.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 14.
Modello:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- SubnetId
-
L'ID della sottorete del target di montaggio.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 15. La lunghezza massima è 47 caratteri.
Modello:
^subnet-[0-9a-f]{8,40}$
- VpcId
-
L'ID del cloud privato virtuale (VPC) in cui è configurato il mount target.
▬Tipo: stringa
Errori
- AvailabilityZonesMismatch
-
Restituito se la zona di disponibilità specificata per un target di montaggio è diversa dalla zona di disponibilità specificata per lo storage a zona singola. Per ulteriori informazioni, consulta Ridondanza dello storage a livello regionale e a zona unica.
HTTPCodice di stato: 400
- 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
- IncorrectFileSystemLifeCycleState
-
Restituito se lo stato del ciclo di vita del file system non è “disponibile”.
HTTPCodice di stato: 409
- InternalServerError
-
Restituito se si è verificato un errore lato server.
HTTPCodice di stato: 500
- IpAddressInUse
-
Restituito se la richiesta
IpAddress
ha specificato un elemento già in uso nella sottorete.HTTPCodice di stato: 409
- MountTargetConflict
-
Restituito se il target di montaggio viola una delle restrizioni specificate in base ai target di montaggio esistenti del file system.
HTTPCodice di stato: 409
- NetworkInterfaceLimitExceeded
-
L'account chiamante ha raggiunto il limite per le interfacce di rete elastiche per lo specifico Regione AWS. Elimina alcune interfacce di rete o richiedi l'aumento della quota dell'account. Per ulteriori informazioni, consulta Amazon VPC Quotas nella Amazon VPC User Guide (consulta la voce Interfacce di rete per regione nella tabella Interfacce di rete).
HTTPCodice di stato: 409
- NoFreeAddressesInSubnet
-
Restituito se
IpAddress
non è stato specificato nella richiesta e non vi sono indirizzi IP liberi nella sottorete.HTTPCodice di stato: 409
- SecurityGroupLimitExceeded
-
Restituito se la dimensione dei
SecurityGroups
specificata nella richiesta è maggiore di cinque.HTTPCodice di stato: 400
- SecurityGroupNotFound
-
Restituito se uno dei gruppi di sicurezza specificati non esiste nel cloud privato virtuale della sottorete (VPC).
HTTPCodice di stato: 400
- SubnetNotFound
-
Restituito se non è presente alcuna sottorete con l'ID
SubnetId
fornito nella richiesta.HTTPCodice di stato: 400
- UnsupportedAvailabilityZone
-
Restituito se la EFS funzionalità Amazon richiesta non è disponibile nella zona di disponibilità specificata.
HTTPCodice di stato: 400
Esempi
Aggiunta di un target di montaggio a un file system
La richiesta che segue crea un target di montaggio per un file system. La richiesta specifica i valori solo per i parametri obbligatori FileSystemId
e SubnetId
. La richiesta non fornisce i parametri IpAddress
e SecurityGroups
opzionali. Per IpAddress
, l'operazione utilizza uno degli indirizzi IP disponibili nella sottorete specificata. Inoltre, l'operazione utilizza il gruppo di sicurezza predefinito associato VPC aSecurityGroups
.
Richiesta di esempio
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
Risposta di esempio
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"MountTargetId": "fsmt-55a4413c",
"NetworkInterfaceId": "eni-01234567",
"FileSystemId": "fs-01234567",
"LifeCycleState": "available",
"SubnetId": "subnet-01234567",
"OwnerId": "231243201240",
"IpAddress": "172.31.22.183"
}
Aggiunta di un target di montaggio a un file system
La seguente richiesta specifica tutti i parametri della richiesta per creare un target di montaggio.
Richiesta di esempio
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddress":"10.0.2.42",
"SecurityGroups":[
"sg-01234567"
]
}
Risposta di esempio
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
}
Vedi anche
Per ulteriori informazioni sull'utilizzo di questo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: