En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes mediante el uso de la AWS Command Line Interface con Amazon EFS.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar create-file-system
.
- AWS CLI
-
Para crear un sistema de archivos cifrado
En el siguiente ejemplo de
create-file-system
, se crea un sistema de archivos cifrado con la CMK predeterminada. También se agrega la etiquetaName=my-file-system
.aws efs create-file-system \ --performance-mode
generalPurpose
\ --throughput-modebursting
\ --encrypted \ --tagsKey=Name,Value=my-file-system
Salida:
{ "OwnerId": "123456789012", "CreationToken": "console-d7f56c5f-e433-41ca-8307-9d9c0example", "FileSystemId": "fs-c7a0456e", "FileSystemArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-48499b4d", "CreationTime": 1595286880.0, "LifeCycleState": "creating", "Name": "my-file-system", "NumberOfMountTargets": 0, "SizeInBytes": { "Value": 0, "ValueInIA": 0, "ValueInStandard": 0 }, "PerformanceMode": "generalPurpose", "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/a59b3472-e62c-42e4-adcf-30d92example", "ThroughputMode": "bursting", "Tags": [ { "Key": "Name", "Value": "my-file-system" } ] }
Para obtener más información, consulte Creating Amazon EFS file systems en la Guía del usuario de Amazon Elastic File System.
-
Para obtener información sobre la API, consulte CreateFileSystem
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-mount-target
.
- AWS CLI
-
Para crear un destino de montaje
En el siguiente ejemplo de
create-mount-target
, se crea un destino de montaje para el sistema de archivos especificado.aws efs create-mount-target \ --file-system-id
fs-c7a0456e
\ --subnet-idsubnet-02bf4c428bexample
\ --security-groupssg-068f739363example
Salida:
{ "OwnerId": "123456789012", "MountTargetId": "fsmt-f9a14450", "FileSystemId": "fs-c7a0456e", "SubnetId": "subnet-02bf4c428bexample", "LifeCycleState": "creating", "IpAddress": "10.0.1.24", "NetworkInterfaceId": "eni-02d542216aexample", "AvailabilityZoneId": "use2-az2", "AvailabilityZoneName": "us-east-2b", "VpcId": "vpc-0123456789abcdef0" }
Para obtener más información, consulte Creating mount targets en la Guía del usuario de Amazon Elastic File System.
-
Para obtener información sobre la API, consulte CreateMountTarget
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-file-system
.
- AWS CLI
-
Para eliminar un sistema de archivos
En el siguiente ejemplo de
delete-file-system
, se elimina el sistema de archivos especificado.aws efs delete-file-system \ --file-system-id
fs-c7a0456e
Este comando no genera ninguna salida.
Para obtener más información, consulte Deleting an Amazon EFS file system en la Guía del usuario de Amazon Elastic File System.
-
Para obtener información sobre la API, consulte DeleteFileSystem
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-mount-target
.
- AWS CLI
-
Para eliminar un destino de montaje
En el siguiente ejemplo de
delete-mount-target
, se elimina el destino de montaje especificado.aws efs delete-mount-target \ --mount-target-id
fsmt-f9a14450
Este comando no genera ninguna salida.
Para obtener más información, consulte Creating mount targets en la Guía del usuario de Amazon Elastic File System.
-
Para obtener información sobre la API, consulte DeleteMountTarget
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-file-systems
.
- AWS CLI
-
Para describir un sistema de archivos
En el siguiente ejemplo de
describe-file-systems
, se describe el sistema de archivos especificado.aws efs describe-file-systems \ --file-system-id
fs-c7a0456e
Salida:
{ "FileSystems": [ { "OwnerId": "123456789012", "CreationToken": "console-d7f56c5f-e433-41ca-8307-9d9c0example", "FileSystemId": "fs-c7a0456e", "FileSystemArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-48499b4d", "CreationTime": 1595286880.0, "LifeCycleState": "available", "Name": "my-file-system", "NumberOfMountTargets": 3, "SizeInBytes": { "Value": 6144, "Timestamp": 1600991437.0, "ValueInIA": 0, "ValueInStandard": 6144 }, "PerformanceMode": "generalPurpose", "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/a59b3472-e62c-42e4-adcf-30d92example", "ThroughputMode": "bursting", "Tags": [ { "Key": "Name", "Value": "my-file-system" } ] } ] }
Para obtener más información, consulte Managing Amazon EFS file systems en la Guía del usuario de Amazon Elastic File System.
-
Para obtener información sobre la API, consulte DescribeFileSystems
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-mount-targets
.
- AWS CLI
-
Para describir un destino de montaje
En el siguiente ejemplo de
describe-mount-targets
, se describe el destino de montaje especificado.aws efs describe-mount-targets \ --mount-target-id
fsmt-f9a14450
Salida:
{ "MountTargets": [ { "OwnerId": "123456789012", "MountTargetId": "fsmt-f9a14450", "FileSystemId": "fs-c7a0456e", "SubnetId": "subnet-02bf4c428bexample", "LifeCycleState": "creating", "IpAddress": "10.0.1.24", "NetworkInterfaceId": "eni-02d542216aexample", "AvailabilityZoneId": "use2-az2", "AvailabilityZoneName": "us-east-2b", "VpcId": "vpc-0123456789abcdef0" } ] }
Para obtener más información, consulte Creating mount targets en la Guía del usuario de Amazon Elastic File System.
-
Para obtener información sobre la API, consulte DescribeMountTargets
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-tags
.
- AWS CLI
-
Para describir las etiquetas de un sistema de archivos
En el siguiente ejemplo de
describe-tags
, se describen las etiquetas del sistema de archivos especificado.aws efs describe-tags \ --file-system-id
fs-c7a0456e
Salida:
{ "Tags": [ { "Key": "Name", "Value": "my-file-system" }, { "Key": "Department", "Value": "Business Intelligence" } ] }
Para obtener más información, consulte Managing file system tags en la Guía del usuario de Amazon Elastic File System.
-
Para obtener detalles sobre la API, consulte DescribeTags
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource
.
- AWS CLI
-
Para recuperar las etiquetas de un recurso
En el siguiente ejemplo de
list-tags-for-resource
, se recuperan las etiquetas asociadas al sistema de archivos especificado.aws efs list-tags-for-resource \ --resource-id
fs-c7a0456e
Salida:
{ "Tags": [ { "Key": "Name", "Value": "my-file-system" }, { "Key": "Department", "Value": "Business Intelligence" } ] }
Para obtener más información, consulte Managing file system tags en la Guía del usuario de Amazon Elastic File System.
-
Para ver los detalles de la API, consulte ListTagsForResource
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar tag-resource
.
- AWS CLI
-
Para etiquetar un recurso
En el siguiente ejemplo de
tag-resource
, se agrega la etiquetaDepartment=Business Intelligence
al sistema de archivos especificado.aws efs tag-resource \ --resource-id
fs-c7a0456e
\ --tags Key=Department,Value="Business Intelligence"Este comando no genera ninguna salida.
Para obtener más información, consulte Managing file system tags en la Guía del usuario de Amazon Elastic File System.
-
Para ver los detalles de la API, consulte TagResource
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar untag-resource
.
- AWS CLI
-
Para eliminar una etiqueta de un recurso
En el siguiente ejemplo de
untag-resource
, se elimina la etiqueta con la clave de etiquetaDepartment
del sistema de archivos especificado.aws efs untag-resource \ --resource-id
fs-c7a0456e
\ --tag-keysDepartment
Este comando no genera ninguna salida.
Para obtener más información, consulte Managing file system tags en la Guía del usuario de Amazon Elastic File System.
-
Para ver los detalles de la API, consulte UntagResource
en la Referencia de comandos de la AWS CLI.
-