使用 的 Amazon EFS範例 AWS CLI - AWS Command Line Interface
動作

本文件 AWS CLI 僅適用於 的第 1 版。如需與 第 2 版相關的文件 AWS CLI，請參閱 第 2 版使用者指南 。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 的 Amazon EFS範例 AWS CLI

下列程式碼範例示範如何搭配 Amazon AWS Command Line Interface 使用 來執行動作和實作常見案例EFS。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會示範如何呼叫個別服務函數，但您可以在其相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 create-file-system。

AWS CLI

若要建立加密的檔案系統

下列create-file-system範例會使用預設 建立加密的檔案系統CMK。它也會新增標籤 Name=my-file-system。

aws efs create-file-system \
    --performance-mode generalPurpose \
    --throughput-mode bursting \
    --encrypted \
    --tags Key=Name,Value=my-file-system

輸出：

{
    "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"
        }
    ]
}

如需詳細資訊，請參閱 Amazon Elastic EFS File System 使用者指南 中的建立 Amazon 檔案系統。 Amazon Elastic File System

  • 如需API詳細資訊，請參閱 命令參考 CreateFileSystem中的 。 AWS CLI

下列程式碼範例示範如何使用 create-mount-target。

AWS CLI

建立掛載目標

下列create-mount-target範例會為指定的檔案系統建立掛載目標。

aws efs create-mount-target \
    --file-system-id fs-c7a0456e \
    --subnet-id subnet-02bf4c428bexample \
    --security-groups sg-068f739363example

輸出：

{
    "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"
}

如需詳細資訊，請參閱 Amazon Elastic File System 使用者指南 中的建立掛載目標。

下列程式碼範例示範如何使用 delete-file-system。

AWS CLI

若要刪除檔案系統

下列delete-file-system範例會刪除指定的檔案系統。

aws efs delete-file-system \
    --file-system-id fs-c7a0456e

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Elastic EFS File System 使用者指南 中的刪除 Amazon 檔案系統。 Amazon Elastic File System

  • 如需API詳細資訊，請參閱 命令參考 DeleteFileSystem中的 。 AWS CLI

下列程式碼範例示範如何使用 delete-mount-target。

AWS CLI

若要刪除掛載目標

下列delete-mount-target範例會刪除指定的掛載目標。

aws efs delete-mount-target \
    --mount-target-id fsmt-f9a14450

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Elastic File System 使用者指南 中的建立掛載目標。

下列程式碼範例示範如何使用 describe-file-systems。

AWS CLI

描述檔案系統

下列describe-file-systems範例說明指定的檔案系統。

aws efs describe-file-systems \
    --file-system-id fs-c7a0456e

輸出：

{
    "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"
                }
            ]
        }
    ]
}

如需詳細資訊，請參閱 Amazon Elastic EFS File System 使用者指南 中的管理 Amazon 檔案系統。 Amazon Elastic File System

下列程式碼範例示範如何使用 describe-mount-targets。

AWS CLI

描述掛載目標

下列describe-mount-targets範例說明指定的掛載目標。

aws efs describe-mount-targets \
    --mount-target-id fsmt-f9a14450

輸出：

{
    "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"
        }
    ]
}

如需詳細資訊，請參閱 Amazon Elastic File System 使用者指南 中的建立掛載目標。

下列程式碼範例示範如何使用 describe-tags。

AWS CLI

描述檔案系統的標籤

下列describe-tags範例說明指定檔案系統的標籤。

aws efs describe-tags \
    --file-system-id fs-c7a0456e

輸出：

{
    "Tags": [
        {
            "Key": "Name",
            "Value": "my-file-system"
        },
        {
            "Key": "Department",
            "Value": "Business Intelligence"
        }
    ]
}

如需詳細資訊，請參閱 Amazon Elastic File System File System 使用者指南 中的管理檔案系統標籤。

  • 如需API詳細資訊，請參閱 命令參考 DescribeTags中的 。 AWS CLI

下列程式碼範例示範如何使用 list-tags-for-resource。

AWS CLI

擷取資源的標籤

下列list-tags-for-resource範例會擷取與指定檔案系統相關聯的標籤。

aws efs list-tags-for-resource \
    --resource-id fs-c7a0456e

輸出：

{
    "Tags": [
        {
            "Key": "Name",
            "Value": "my-file-system"
        },
        {
            "Key": "Department",
            "Value": "Business Intelligence"
        }
    ]
}

如需詳細資訊，請參閱 Amazon Elastic File System File System 使用者指南 中的管理檔案系統標籤。

下列程式碼範例示範如何使用 tag-resource。

AWS CLI

標記資源

下列tag-resource範例會將標籤新增至Department=Business Intelligence指定的檔案系統。

aws efs tag-resource \
    --resource-id fs-c7a0456e \
    --tags Key=Department,Value="Business Intelligence"

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Elastic File System File System 使用者指南 中的管理檔案系統標籤。

  • 如需API詳細資訊，請參閱 命令參考 TagResource中的 。 AWS CLI

下列程式碼範例示範如何使用 untag-resource。

AWS CLI

從資源中移除標籤

下列untag-resource範例會從指定的檔案系統移除具有標籤索引鍵的Department標籤。

aws efs untag-resource \
    --resource-id fs-c7a0456e \
    --tag-keys Department

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon Elastic File System File System 使用者指南 中的管理檔案系統標籤。

  • 如需API詳細資訊，請參閱 命令參考 UntagResource中的 。 AWS CLI