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

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 unIpAddress, 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 EC2 CreateNetworkInterface 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 cui fsmt-id è l'ID del target di montaggio e fs-id è il FileSystemId.

    • Imposta la proprietà requesterManaged dell'interfaccia di rete su true e il valore requesterId su EFS.

    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 il IpAddress campo sul relativo indirizzo. Se la creazione dell'interfaccia di rete non riesce, l'intera operazione CreateMountTarget 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. Inoltre, usando sempre un target di montaggio locale alla zona di disponibilità dell'istanza, è possibile eliminare lo scenario del fallimento parziale. Se la zona di disponibilità in cui viene creata il target di montaggio diventa inutilizzabile, non sarà possibile accedere al file system tramite i target di montaggio.

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 modulosg-xxxxxxxx. Questi devono corrispondere alla sottorete specificata. VPC

Tipo: 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 quella us-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 AWS

HTTPCodice 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: