Sintassi della richiesta Parametri della richiesta URI:Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Esempi Vedi anche

CreateMountTarget

Crea un target di montaggio per un file system. È quindi possibile montare il file system sulle EC2 istanze utilizzando la destinazione di montaggio. Per ulteriori informazioni sulle destinazioni di montaggio, vedere Gestione delle destinazioni di montaggio.

Per creare una destinazione di montaggio per un file system EFS, lo stato del ciclo di vita del file system deve essere. available Per ulteriori informazioni, consulta DescribeFileSystems.

Dopo aver creato la destinazione di montaggio, Amazon EFS restituisce una risposta che include un indirizzo IP MountTargetId e un indirizzo IP (IpAddressoIpv6Address). Utilizzi questo indirizzo IP per montare il file system in un' EC2 istanza. Durante il montaggio del file system è anche possibile utilizzare il nome DNS del target di montaggio. L' EC2 istanza su cui si monta il file system utilizzando la destinazione di montaggio può risolvere il nome DNS della destinazione di montaggio nel relativo indirizzo IP. Per ulteriori informazioni, consulta Come funziona Amazon EFS.

Tieni presente che è possibile creare target di montaggio per un file system in un solo VPC e che può esserci un solo target di montaggio per ogni zona di disponibilità. Per ulteriori informazioni, consulta Creazione di target di montaggio.

Se la richiesta soddisfa i requisiti, Amazon EFS procede in questo modo:

Crea un nuovo target di montaggio nella sottorete specificata.
Crea una nuova interfaccia di rete nella sottorete con quanto segue:
- La descrizione Mount target fsmt-id for file system fs-id dove fsmt-id è l'ID del target di montaggio, ed fs-id è. FileSystemId
- La requesterManaged proprietà dell'interfaccia di rete è impostata su e il requesterId valore impostato suEFS. true
Ogni destinazione di montaggio ha una corrispondente interfaccia di EC2 rete gestita dal richiedente. Dopo aver creato l'interfaccia di rete, Amazon EFS imposta il NetworkInterfaceId campo nella descrizione della destinazione di montaggio sull'ID dell'interfaccia di rete e l'indirizzo IP 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.

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",
   "IpAddressType": "string",
   "Ipv6Address": "string",
   "SecurityGroups": [ "string" ],
   "SubnetId": "string"
}

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

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

Se IpAddressType for the mount target è IPv4 (IPV4_ONLYoDUAL_STACK), specifica l' IPv4 indirizzo da utilizzare. Se non lo specifichiIpAddress, Amazon EFS seleziona un indirizzo IP inutilizzato dalla sottorete specificata per. SubnetId

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

IpAddressType

Il tipo di indirizzo IP per la destinazione di montaggio. I valori possibili sono IPV4_ONLY (solo IPv4 indirizzi), IPV6_ONLY (solo IPv6 indirizzi) e DUAL_STACK (dual-stack, entrambi IPv4 e IPv6 indirizzi). Se non si specifica unIpAddressType, allora viene IPV4_ONLY utilizzato.

Nota

IPAddressTypeDeve corrispondere al tipo di IP della sottorete. Inoltre, il IPAddressType parametro sostituisce il valore impostato come indirizzo IP predefinito per la sottorete nel VPC. Ad esempio, se IPAddressType è IPV4_ONLY ed ètrue, allora AssignIpv6AddressOnCreation IPv4 viene utilizzato per la destinazione di montaggio. Per ulteriori informazioni, consulta la sezione Modifica dell'attributo di assegnazione degli indirizzi IP della sottorete.

Tipo: stringa

Valori validi: IPV4_ONLY | IPV6_ONLY | DUAL_STACK

Campo obbligatorio: no

Ipv6Address

Se IPAddressType for the mount target è IPv6 (IPV6_ONLYoDUAL_STACK), allora specifica l' IPv6 indirizzo da utilizzare. Se non lo specifichiIpv6Address, Amazon EFS seleziona un indirizzo IP inutilizzato dalla sottorete specificata per. SubnetId

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 3. Lunghezza massima di 39.

Campo obbligatorio: no

SecurityGroups

Gruppo di sicurezza VPC IDs, del modulo. sg-xxxxxxxx Questi devono essere per lo stesso VPC della sottorete specificata. Il numero massimo di gruppi di sicurezza dipende dalla quota dell'account. Per ulteriori informazioni, consulta Amazon VPC Quotas nella Amazon VPC User Guide (consulta la tabella dei gruppi di sicurezza). Se non specifichi un gruppo di sicurezza, Amazon EFS utilizza il gruppo di sicurezza predefinito per il VPC della sottorete.

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. Il tipo di sottorete deve essere dello stesso tipo di. IpAddressType

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",
   "Ipv6Address": "string",
   "LifeCycleState": "string",
   "MountTargetId": "string",
   "NetworkInterfaceId": "string",
   "OwnerId": "string",
   "SubnetId": "string",
   "VpcId": "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.

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

L' IPv4 indirizzo per la destinazione 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}$

Ipv6Address

L' IPv6 indirizzo per il target di montaggio.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 3. Lunghezza massima di 39.

LifeCycleState

Stato del ciclo di vita del target di montaggio.

Tipo: stringa

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 creata da Amazon EFS al momento della creazione del target di montaggio.

Tipo: stringa

OwnerId

Account AWS ID proprietario della 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 target di montaggio.

Tipo: stringa

Errori

AvailabilityZonesMismatch

Restituito se la zona di disponibilità specificata per la destinazione di montaggio è diversa dalla zona di disponibilità del file system. Per ulteriori informazioni, consulta Ridondanza dello storage a livello regionale e a zona unica.

Codice di stato HTTP: 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.

Codice di stato HTTP: 400

FileSystemNotFound

Restituito se il FileSystemId valore specificato non esiste nella cartella del richiedente. Account AWS

Codice di stato HTTP: 404

IncorrectFileSystemLifeCycleState

Restituito se lo stato del ciclo di vita del file system non è “disponibile”.

Codice di stato HTTP: 409

InternalServerError

Restituito se si è verificato un errore lato server.

Codice di stato HTTP: 500

IpAddressInUse

Restituito se la richiesta ha specificato un indirizzo IP (IpAddressoIpv6Address) che è già in uso nella sottorete.

Codice di stato HTTP: 409

MountTargetConflict

Restituito se il target di montaggio viola una delle restrizioni specificate in base ai target di montaggio esistenti del file system.

Codice di stato HTTP: 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 Quote di Amazon VPC nella Guida per l’utente di Amazon VPC (vedi la voce Interfacce di rete per regione nella tabella Interfacce di rete).

Codice di stato HTTP: 409

NoFreeAddressesInSubnet

Ha restituito no IpAddress o Ipv6Address è stato fornito nella richiesta e non ci sono indirizzi IP liberi nella sottorete specificata.

Codice di stato HTTP: 409

SecurityGroupLimitExceeded

Restituito se il numero SecurityGroups specificato nella richiesta è superiore al limite, che si basa sulla quota dell'account. Elimina alcuni gruppi di sicurezza o richiedi l'aumento della quota dell'account. Per ulteriori informazioni, consulta Amazon VPC Quotas nella Amazon VPC User Guide (consulta la tabella dei gruppi di sicurezza).

Codice di stato HTTP: 400

SecurityGroupNotFound

Restituito se uno dei gruppi di sicurezza specificati non esiste nel cloud privato virtuale (VPC) della sottorete.

Codice di stato HTTP: 400

SubnetNotFound

Restituito se non è presente alcuna sottorete con l'ID SubnetId fornito nella richiesta.

Codice di stato HTTP: 400

UnsupportedAvailabilityZone

Restituito se la funzionalità Amazon EFS richiesta non è disponibile nella zona di disponibilità specificata.

Codice di stato HTTP: 400

Esempi

Crea un target di montaggio a un IPv4 indirizzo disponibile su una sottorete

La richiesta seguente specifica solo il file system e la sottorete per la destinazione di montaggio. La destinazione viene creata a un IPv4 indirizzo disponibile nella sottorete specificata, con il gruppo di sicurezza predefinito associato al VPC.

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

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "NetworkInterfaceId":"eni-1bcb7772"
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Crea un target di montaggio a un indirizzo specifico IPv4

La richiesta seguente specifica il file system, la sottorete, il gruppo di sicurezza e l' IPv4indirizzo da utilizzare per la destinazione 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"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Crea una destinazione di montaggio a un indirizzo specifico IPv6

La richiesta seguente specifica il file system, la sottorete, il gruppo di sicurezza e l' IPv6indirizzo da utilizzare per la destinazione 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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "IpAddressType": "IPV6_ONLY",
   "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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Crea una destinazione di montaggio a un IPv4 indirizzo disponibile su una sottorete dual-stack

La richiesta seguente specifica il file system, la sottorete e il tipo di indirizzo per la destinazione di montaggio. La destinazione viene creata a un IPv4 indirizzo disponibile nella sottorete dual-stack specificata, con il gruppo di sicurezza predefinito associato al VPC.

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

{
    "OwnerId": "251839141158",
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId":"subnet-fd04ff94",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Crea un target di montaggio su Ipv4 e indirizzi specifici su una sottorete dual-stack IPv6

La seguente richiesta specifica il file system, la sottorete, il gruppo di sicurezza, l'indirizzo e l'indirizzo per la destinazione di montaggio. IPv4 IPv6 La destinazione viene creata all' IPv6indirizzo IPv4 e specificato su una sottorete dual-stack.

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",
   "IpAddressType": "DUAL_STACK",
   "IpAddress": "10.0.1.25",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "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": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "10.0.1.25",
    "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Vedi anche

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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CreateFileSystem

CreateReplicationConfiguration