使用 的 Network Manager 範例 AWS CLI - AWS Command Line Interface
動作

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

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

使用 的 Network Manager 範例 AWS CLI

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

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

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

主題

動作

下列程式碼範例示範如何使用 associate-customer-gateway。

AWS CLI

建立客戶閘道的關聯

下列associate-customer-gateway範例將指定全域網路cgw-11223344556677889中的客戶閘道與裝置 建立關聯device-07f6fd08867abc123。

aws networkmanager associate-customer-gateway \
    --customer-gateway-arn arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889  \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --region us-west-2

輸出：

{
    "CustomerGatewayAssociation": {
        "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "State": "PENDING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的客戶閘道關聯。

下列程式碼範例示範如何使用 associate-link。

AWS CLI

建立連結的關聯

下列associate-link範例會將連結link-11112222aaaabbbb1與裝置 建立關聯device-07f6fd08867abc123。連結和裝置位於指定的全域網路中。

aws networkmanager associate-link \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2

輸出：

{
    "LinkAssociation": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "LinkId": "link-11112222aaaabbbb1",
        "LinkAssociationState": "PENDING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的裝置和連結關聯。

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

下列程式碼範例示範如何使用 create-core-network。

AWS CLI

建立核心網路

下列create-core-network範例使用 AWS Cloud WAN全域網路中的選用描述和標籤建立核心網路。

aws networkmanager create-core-network \
    --global-network-id global-network-cdef-EXAMPLE22222 \
    --description "Main headquarters location" \
    --tags Key=Name,Value="New York City office"

輸出：

{
    "CoreNetwork": {
        "GlobalNetworkId": "global-network-cdef-EXAMPLE22222",
        "CoreNetworkId": "core-network-cdef-EXAMPLE33333",
        "CoreNetworkArn": "arn:aws:networkmanager::987654321012:core-network/core-network-cdef-EXAMPLE33333",
        "Description": "Main headquarters location",
        "CreatedAt": "2022-01-10T19:53:59+00:00",
        "State": "AVAILABLE",
        "Tags": [
            {
                "Key": "Name",
                "Value": "New York City office"
            }
        ]
    }
}

如需詳細資訊，請參閱 AWS 雲端WAN使用者指南 中的全域和核心網路。

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

AWS CLI

若要建立裝置

下列create-device範例會在指定的全域網路中建立裝置。裝置詳細資訊包括描述、類型、廠商、模型和序號。

aws networkmanager create-device
    --global-network-id global-network-01231231231231231 \
    --description "New York office device" \
    --type "office device" \
    --vendor "anycompany" \
    --model "abcabc" \
    --serial-number "1234" \
    --region us-west-2

輸出：

{
    "Device": {
        "DeviceId": "device-07f6fd08867abc123",
        "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York office device",
        "Type": "office device",
        "Vendor": "anycompany",
        "Model": "abcabc",
        "SerialNumber": "1234",
        "CreatedAt": 1575554005.0,
        "State": "PENDING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用裝置。

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

下列程式碼範例示範如何使用 create-global-network。

AWS CLI

建立全域網路

下列create-global-network範例會建立新的全域網路。建立時的初始狀態為 PENDING。

aws networkmanager create-global-network

輸出：

{
    "GlobalNetwork": {
        "GlobalNetworkId": "global-network-00a77fc0f722dae74",
        "GlobalNetworkArn": "arn:aws:networkmanager::987654321012:global-network/global-network-00a77fc0f722dae74",
        "CreatedAt": "2022-03-14T20:31:56+00:00",
        "State": "PENDING"
    }
}

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

AWS CLI

若要建立連結

下列create-link範例會在指定的全域網路中建立連結。連結包含有關連結類型、頻寬和提供者的說明和詳細資訊。網站 ID 表示連結相關聯的網站。

aws networkmanager create-link \
    --global-network-id global-network-01231231231231231 \
    --description "VPN Link" \
    --type "broadband" \
    --bandwidth UploadSpeed=10,DownloadSpeed=20 \
    --provider "AnyCompany" \
    --site-id site-444555aaabbb11223 \
    --region us-west-2

輸出：

{
    "Link": {
        "LinkId": "link-11112222aaaabbbb1",
        "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
        "GlobalNetworkId": "global-network-01231231231231231",
        "SiteId": "site-444555aaabbb11223",
        "Description": "VPN Link",
        "Type": "broadband",
        "Bandwidth": {
            "UploadSpeed": 10,
            "DownloadSpeed": 20
        },
        "Provider": "AnyCompany",
        "CreatedAt": 1575555811.0,
        "State": "PENDING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用連結。

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

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

AWS CLI

建立網站

下列create-site範例會在指定的全域網路中建立站台。網站詳細資訊包含描述和位置資訊。

aws networkmanager create-site \
    --global-network-id global-network-01231231231231231 \
    --description  "New York head office" \
    --location Latitude=40.7128,Longitude=-74.0060 \
    --region us-west-2

輸出：

{
    "Site": {
        "SiteId": "site-444555aaabbb11223",
        "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York head office",
        "Location": {
            "Latitude": "40.7128",
            "Longitude": "-74.0060"
        },
        "CreatedAt": 1575554300.0,
        "State": "PENDING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用網站。

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

下列程式碼範例示範如何使用 create-vpc-attachment。

AWS CLI

若要建立VPC附件

下列create-vpc-attachment範例會在核心網路中建立IPv6支援 的VPC附件。

aws networkmanager create-vpc-attachment \
    --core-network-id core-network-0fab62fe438d94db6 \
    --vpc-arn arn:aws:ec2:us-east-1:987654321012:vpc/vpc-09f37f69e2786eeb8  \
    --subnet-arns arn:aws:ec2:us-east-1:987654321012:subnet/subnet-04ca4e010857e7bb7 \
    --Ipv6Support=true

輸出：

{
    "VpcAttachment": {
        "Attachment": {
            "CoreNetworkId": "core-network-0fab62fe438d94db6",
            "AttachmentId": "attachment-05e1da6eba87a06e6",
            "OwnerAccountId": "987654321012",
            "AttachmentType": "VPC",
            "State": "CREATING",
            "EdgeLocation": "us-east-1",
            "ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-09f37f69e2786eeb8",
            "Tags": [],
            "CreatedAt": "2022-03-10T20:59:14+00:00",
            "UpdatedAt": "2022-03-10T20:59:14+00:00"
        },
        "SubnetArns": [
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-04ca4e010857e7bb7"
        ],
        "Options": {
            "Ipv6Support": true
        }
    }
}

如需詳細資訊，請參閱 雲端WAN使用者指南 中的建立附件。

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

AWS CLI

若要刪除附件

下列delete-attachment範例會刪除 Connect 附件。

aws networkmanager delete-attachment \
    --attachment-id attachment-01feddaeae26ab68c

輸出：

{
    "Attachment": {
        "CoreNetworkId": "core-network-0f4b0a9d5ee7761d1",
        "AttachmentId": "attachment-01feddaeae26ab68c",
        "OwnerAccountId": "987654321012",
        "AttachmentType": "CONNECT",
        "State": "DELETING",
        "EdgeLocation": "us-east-1",
        "ResourceArn": "arn:aws:networkmanager::987654321012:attachment/attachment-02c3964448fedf5aa",
        "CreatedAt": "2022-03-15T19:18:41+00:00",
        "UpdatedAt": "2022-03-15T19:28:59+00:00"
    }
}

如需詳細資訊，請參閱 雲端WAN使用者指南 中的刪除附件。

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

下列程式碼範例示範如何使用 delete-bucket-analytics-configuration。

AWS CLI

刪除儲存貯體的分析組態

下列delete-bucket-analytics-configuration範例會移除指定儲存貯體和 ID 的分析組態。

aws s3api delete-bucket-analytics-configuration \
    --bucket my-bucket \
    --id 1

此命令不會產生輸出。

下列程式碼範例示範如何使用 delete-bucket-metrics-configuration。

AWS CLI

刪除儲存貯體的指標組態

下列delete-bucket-metrics-configuration範例會移除指定儲存貯體和 ID 的指標組態。

aws s3api delete-bucket-metrics-configuration \
    --bucket my-bucket \
    --id 123

此命令不會產生輸出。

下列程式碼範例示範如何使用 delete-core-network。

AWS CLI

刪除核心網路

下列delete-core-network範例會從 Cloud WAN全域網路刪除核心網路。

aws networkmanager delete-core-network \
    --core-network-id core-network-0fab62fe438d94db6

輸出：

{
    "CoreNetwork": {
        "GlobalNetworkId": "global-network-0d59060f16a73bc41",
        "CoreNetworkId": "core-network-0fab62fe438d94db6",
        "Description": "Main headquarters location",
        "CreatedAt": "2021-12-09T18:31:11+00:00",
        "State": "DELETING",
        "Segments": [
            {
                "Name": "dev",
                "EdgeLocations": [
                    "us-east-1"
                ],
                "SharedSegments": []
            }
        ],
        "Edges": [
            {
                "EdgeLocation": "us-east-1",
                "Asn": 64512,
                "InsideCidrBlocks": []
            }
        ]
    }
}

如需詳細資訊，請參閱 雲端WAN使用者指南 中的核心網路。

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

AWS CLI

若要刪除裝置

下列delete-device範例會從指定的全域網路刪除指定的裝置。

aws networkmanager delete-device \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --region us-west-2

輸出：

{
    "Device": {
        "DeviceId": "device-07f6fd08867abc123",
        "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York office device",
        "Type": "office device",
        "Vendor": "anycompany",
        "Model": "abcabc",
        "SerialNumber": "1234",
        "SiteId": "site-444555aaabbb11223",
        "CreatedAt": 1575554005.0,
        "State": "DELETING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用 裝置。

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

下列程式碼範例示範如何使用 delete-global-network。

AWS CLI

若要刪除全域網路

下列delete-global-network範例會刪除全域網路。

aws networkmanager delete-global-network \
    --global-network-id global-network-052bedddccb193b6b

輸出：

{
    "GlobalNetwork": {
        "GlobalNetworkId": "global-network-052bedddccb193b6b",
        "GlobalNetworkArn": "arn:aws:networkmanager::987654321012:global-network/global-network-052bedddccb193b6b",
        "CreatedAt": "2021-12-09T18:19:12+00:00",
        "State": "DELETING"
    }
}

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

AWS CLI

若要刪除連結

下列delete-link範例會從指定的全域網路刪除指定的連結。

aws networkmanager delete-link \
    --global-network-id global-network-01231231231231231  \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2

輸出：

{
    "Link": {
        "LinkId": "link-11112222aaaabbbb1",
        "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
        "GlobalNetworkId": "global-network-01231231231231231",
        "SiteId": "site-444555aaabbb11223",
        "Description": "VPN Link",
        "Type": "broadband",
        "Bandwidth": {
            "UploadSpeed": 20,
            "DownloadSpeed": 20
        },
        "Provider": "AnyCompany",
        "CreatedAt": 1575555811.0,
        "State": "DELETING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用連結。

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

下列程式碼範例示範如何使用 delete-public-access-block。

AWS CLI

刪除儲存貯體的區塊公有存取組態

下列delete-public-access-block範例會移除指定儲存貯體上的區塊公有存取組態。

aws s3api delete-public-access-block \
    --bucket my-bucket

此命令不會產生輸出。

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

AWS CLI

刪除網站

下列delete-site範例會刪除指定全域網路中的指定站台 （site-444555aaabbb11223）。

aws networkmanager delete-site \
    --global-network-id global-network-01231231231231231  \
    --site-id site-444555aaabbb11223 \
    --region us-west-2

輸出：

{
    "Site": {
        "SiteId": "site-444555aaabbb11223",
        "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York head office",
        "Location": {
            "Latitude": "40.7128",
            "Longitude": "-74.0060"
        },
        "CreatedAt": 1575554300.0,
        "State": "DELETING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用網站。

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

下列程式碼範例示範如何使用 deregister-transit-gateway。

AWS CLI

從全域網路取消註冊傳輸閘道

下列deregister-transit-gateway範例會從指定的全域網路取消註冊指定的傳輸閘道。

aws networkmanager deregister-transit-gateway \
    --global-network-id global-network-01231231231231231 \
    --transit-gateway-arn arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc \
    --region us-west-2

輸出：

{
    "TransitGatewayRegistration": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
        "State": {
            "Code": "DELETING"
        }
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的 Transit Gateway 註冊。

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

AWS CLI

描述您的全球網路

下列describe-global-networks範例說明 帳戶中的所有全域網路。

aws networkmanager describe-global-networks \
    --region us-west-2

輸出：

{
    "GlobalNetworks": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231",
            "Description": "Company 1 global network",
            "CreatedAt": 1575553525.0,
            "State": "AVAILABLE"
        }
    ]
}

下列程式碼範例示範如何使用 disassociate-customer-gateway。

AWS CLI

取消客戶閘道的關聯

下列disassociate-customer-gateway範例會將指定的客戶閘道 （cgw-11223344556677889） 與指定的全域網路取消關聯。

aws networkmanager disassociate-customer-gateway \
    --global-network-id global-network-01231231231231231 \
    --customer-gateway-arn arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889 \
    --region us-west-2

輸出：

{
    "CustomerGatewayAssociation": {
        "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "State": "DELETING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的客戶閘道關聯。

下列程式碼範例示範如何使用 disassociate-link。

AWS CLI

若要取消連結的關聯

下列disassociate-link範例會取消指定連結與指定全域網路device-07f6fd08867abc123中裝置的關聯。

aws networkmanager disassociate-link \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2

輸出：

{
    "LinkAssociation": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "LinkId": "link-11112222aaaabbbb1",
        "LinkAssociationState": "DELETING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南 中的裝置和連結關聯。

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

下列程式碼範例示範如何使用 get-bucket-analytics-configuration。

AWS CLI

擷取具有特定 ID 之儲存貯體的分析組態

下列get-bucket-analytics-configuration範例顯示指定儲存貯體和 ID 的分析組態。

aws s3api get-bucket-analytics-configuration \
    --bucket my-bucket \
    --id 1

輸出：

{
    "AnalyticsConfiguration": {
        "StorageClassAnalysis": {},
        "Id": "1"
    }
}

下列程式碼範例示範如何使用 get-bucket-metrics-configuration。

AWS CLI

擷取具有特定 ID 之儲存貯體的指標組態

下列get-bucket-metrics-configuration範例顯示指定儲存貯體和 ID 的指標組態。

aws s3api get-bucket-metrics-configuration \
    --bucket my-bucket \
    --id 123

輸出：

{
    "MetricsConfiguration": {
        "Filter": {
            "Prefix": "logs"
        },
        "Id": "123"
    }
}

下列程式碼範例示範如何使用 get-customer-gateway-associations。

AWS CLI

取得您的客戶閘道關聯

下列get-customer-gateway-associations範例會取得指定全域網路的客戶閘道關聯。

aws networkmanager get-customer-gateway-associations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

輸出：

{
    "CustomerGatewayAssociations": [
        {
            "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
            "GlobalNetworkId": "global-network-01231231231231231",
            "DeviceId": "device-07f6fd08867abc123",
            "State": "AVAILABLE"
        }
    ]
}

下列程式碼範例示範如何使用 get-devices。

AWS CLI

若要取得您的裝置

下列get-devices範例取得指定全域網路中的裝置。

aws networkmanager get-devices \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

輸出：

{
    "Devices": [
        {
            "DeviceId": "device-07f6fd08867abc123",
            "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
            "GlobalNetworkId": "global-network-01231231231231231",
            "Description": "NY office device",
            "Type": "office device",
            "Vendor": "anycompany",
            "Model": "abcabc",
            "SerialNumber": "1234",
            "CreatedAt": 1575554005.0,
            "State": "AVAILABLE"
        }
    ]
}

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

下列程式碼範例示範如何使用 get-link-associations。

AWS CLI

若要取得連結關聯

下列get-link-associations範例會取得指定全域網路中的連結關聯。

aws networkmanager get-link-associations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

輸出：

{
    "LinkAssociations": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "DeviceId": "device-07f6fd08867abc123",
            "LinkId": "link-11112222aaaabbbb1",
            "LinkAssociationState": "AVAILABLE"
        }
    ]
}

下列程式碼範例示範如何使用 get-links。

AWS CLI

若要取得您的連結

下列get-links範例會取得指定全域網路中的連結。

aws networkmanager get-links \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

輸出：

{
    "Links": [
        {
            "LinkId": "link-11112222aaaabbbb1",
            "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
            "GlobalNetworkId": "global-network-01231231231231231",
            "SiteId": "site-444555aaabbb11223",
            "Description": "VPN Link",
            "Type": "broadband",
            "Bandwidth": {
                "UploadSpeed": 10,
                "DownloadSpeed": 20
            },
            "Provider": "AnyCompany",
            "CreatedAt": 1575555811.0,
            "State": "AVAILABLE"
        }
    ]
}

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

下列程式碼範例示範如何使用 get-object-retention。

AWS CLI

擷取物件的物件保留組態

下列get-object-retention範例會擷取指定物件的物件保留組態。

aws s3api get-object-retention \
    --bucket my-bucket-with-object-lock \
    --key doc1.rtf

輸出：

{
    "Retention": {
        "Mode": "GOVERNANCE",
        "RetainUntilDate": "2025-01-01T00:00:00.000Z"
    }
}

下列程式碼範例示範如何使用 get-public-access-block。

AWS CLI

設定或修改儲存貯體的區塊公有存取組態

下列get-public-access-block範例顯示指定儲存貯體的區塊公有存取組態。

aws s3api get-public-access-block --bucket my-bucket

輸出：

{
    "PublicAccessBlockConfiguration": {
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "BlockPublicAcls": true,
        "RestrictPublicBuckets": true
    }
}

下列程式碼範例示範如何使用 get-sites。

AWS CLI

若要取得您的網站

下列get-sites範例取得指定全域網路中的站台。

aws networkmanager get-sites \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

輸出：

{
    "Sites": [
        {
            "SiteId": "site-444555aaabbb11223",
            "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
            "GlobalNetworkId": "global-network-01231231231231231",
            "Description": "NY head office",
            "Location": {
                "Latitude": "40.7128",
                "Longitude": "-74.0060"
            },
            "CreatedAt": 1575554528.0,
            "State": "AVAILABLE"
        }
    ]
}

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

下列程式碼範例示範如何使用 get-transit-gateway-registrations。

AWS CLI

若要取得傳輸閘道註冊

下列get-transit-gateway-registrations範例會取得已註冊至指定全域網路的傳輸閘道。

aws networkmanager get-transit-gateway-registrations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

輸出：

{
    "TransitGatewayRegistrations": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
            "State": {
                "Code": "AVAILABLE"
            }
        }
    ]
}

下列程式碼範例示範如何使用 get-vpc-attachment。

AWS CLI

若要取得VPC附件

下列get-vpc-attachment範例會傳回有關VPC附件的資訊。

aws networkmanager get-vpc-attachment \
    --attachment-id  attachment-03b7ea450134787da

輸出：

{
    "VpcAttachment": {
        "Attachment": {
            "CoreNetworkId": "core-network-0522de1b226a5d7b3",
            "AttachmentId": "attachment-03b7ea450134787da",
            "OwnerAccountId": "987654321012",
            "AttachmentType": "VPC",
            "State": "CREATING",
            "EdgeLocation": "us-east-1",
            "ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-a7c4bbda",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "DevVPC"
                }
            ],
            "CreatedAt": "2022-03-11T17:48:58+00:00",
            "UpdatedAt": "2022-03-11T17:48:58+00:00"
        },
        "SubnetArns": [
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-202cde6c",
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-e5022dba",
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-2387ae02",
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-cda9dffc"
        ],
        "Options": {
            "Ipv6Support": false
        }
    }
}

如需詳細資訊，請參閱 雲端WAN使用者指南 中的附件。

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

下列程式碼範例示範如何使用 list-bucket-analytics-configurations。

AWS CLI

擷取儲存貯體的分析組態清單

以下內容會list-bucket-analytics-configurations擷取指定儲存貯體的分析組態清單。

aws s3api list-bucket-analytics-configurations \
    --bucket my-bucket

輸出：

{
    "AnalyticsConfigurationList": [
        {
            "StorageClassAnalysis": {},
            "Id": "1"
        }
    ],
    "IsTruncated": false
}

下列程式碼範例示範如何使用 list-bucket-metrics-configurations。

AWS CLI

擷取儲存貯體的指標組態清單

下列list-bucket-metrics-configurations範例會擷取指定儲存貯體的指標組態清單。

aws s3api list-bucket-metrics-configurations \
    --bucket my-bucket

輸出：

{
    "IsTruncated": false,
    "MetricsConfigurationList": [
        {
            "Filter": {
                "Prefix": "logs"
            },
            "Id": "123"
        },
        {
            "Filter": {
                "Prefix": "tmp"
            },
            "Id": "234"
        }
    ]
}

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

AWS CLI

列出資源的標籤

下列list-tags-for-resource範例列出指定裝置資源的標籤 （device-07f6fd08867abc123）。

aws networkmanager list-tags-for-resource \
    --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \
    --region us-west-2

輸出：

{
    "TagList": [
        {
            "Key": "Network",
            "Value": "Northeast"
        }
    ]
}

下列程式碼範例示範如何使用 put-bucket-metrics-configuration。

AWS CLI

設定儲存貯體的指標組態

下列put-bucket-metrics-configuration範例會為指定的儲存貯體設定 ID 為 123 的指標組態。

aws s3api put-bucket-metrics-configuration \
    --bucket my-bucket \
    --id 123 \
    --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'

此命令不會產生輸出。

下列程式碼範例示範如何使用 put-object-retention。

AWS CLI

設定物件的物件保留組態

下列put-object-retention範例會設定指定物件的物件保留組態，直到 2025-01-01。

aws s3api put-object-retention \
    --bucket my-bucket-with-object-lock \
    --key doc1.rtf \
    --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

此命令不會產生輸出。

下列程式碼範例示範如何使用 put-public-access-block。

AWS CLI

設定儲存貯體的區塊公有存取組態

下列put-public-access-block範例會為指定的儲存貯體設定限制性區塊公有存取組態。

aws s3api put-public-access-block \
    --bucket my-bucket \
    --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

此命令不會產生輸出。

下列程式碼範例示範如何使用 register-transit-gateway。

AWS CLI

在全球網路中註冊傳輸閘道

下列register-transit-gateway範例會註冊指定全域網路tgw-123abc05e04123abc中的傳輸閘道。

aws networkmanager register-transit-gateway \
    --global-network-id global-network-01231231231231231 \
    --transit-gateway-arn arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc \
    --region us-west-2

輸出：

{
    "TransitGatewayRegistration": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
        "State": {
            "Code": "PENDING"
        }
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的 Transit Gateway 註冊。

下列程式碼範例示範如何使用 reject-attachment。

AWS CLI

若要拒絕附件

下列reject-attachment範例會拒絕VPC附件請求。

aws networkmanager reject-attachment \
    --attachment-id  attachment-03b7ea450134787da

輸出：

{
    "Attachment": {
        "CoreNetworkId": "core-network-0522de1b226a5d7b3",
        "AttachmentId": "attachment-03b7ea450134787da",
        "OwnerAccountId": "987654321012",
        "AttachmentType": "VPC",
        "State": "AVAILABLE",
        "EdgeLocation": "us-east-1",
        "ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-a7c4bbda",
        "CreatedAt": "2022-03-11T17:48:58+00:00",
        "UpdatedAt": "2022-03-11T17:51:25+00:00"
    }
}

如需詳細資訊，請參閱 雲端WAN使用者指南 中的附件接受。

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

下列程式碼範例示範如何使用 start-route-analysis。

AWS CLI

開始路由分析

下列start-route-analysis範例會啟動來源和目的地之間的分析，包括選用的 include-return-path。

aws networkmanager start-route-analysis \
    --global-network-id global-network-00aa0aaa0b0aaa000 \
    --source TransitGatewayAttachmentArn=arn:aws:ec2:us-east-1:503089527312:transit-gateway-attachment/tgw-attach-0d4a2d491bf68c093,IpAddress=10.0.0.0 \
    --destination TransitGatewayAttachmentArn=arn:aws:ec2:us-west-1:503089527312:transit-gateway-attachment/tgw-attach-002577f30bb181742,IpAddress=11.0.0.0 \
    --include-return-path

輸出：

{
    "RouteAnalysis": {
        "GlobalNetworkId": "global-network-00aa0aaa0b0aaa000
        "OwnerAccountId": "1111222233333",
        "RouteAnalysisId": "a1873de1-273c-470c-1a2bc2345678",
        "StartTimestamp": 1695760154.0,
        "Status": "RUNNING",
        "Source": {
            "TransitGatewayAttachmentArn": "arn:aws:ec2:us-east-1:111122223333:transit-gateway-attachment/tgw-attach-1234567890abcdef0,
            "TransitGatewayArn": "arn:aws:ec2:us-east-1:111122223333:transit-gateway/tgw-abcdef01234567890",
            "IpAddress": "10.0.0.0"
        },
        "Destination": {
            "TransitGatewayAttachmentArn": "arn:aws:ec2:us-west-1:555555555555:transit-gateway-attachment/tgw-attach-021345abcdef6789",
            "TransitGatewayArn": "arn:aws:ec2:us-west-1:111122223333:transit-gateway/tgw-09876543210fedcba0",
            "IpAddress": "11.0.0.0"
        },
        "IncludeReturnPath": true,
        "UseMiddleboxes": false
    }
}

如需詳細資訊，請參閱 AWS Global Networks for Transit Gateways 使用者指南中的 Route Analyzer。

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

AWS CLI

將標籤套用至資源

下列tag-resource範例會將標籤套用至Network=Northeast裝置 device-07f6fd08867abc123。

aws networkmanager tag-resource \
    --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \
    --tags Key=Network,Value=Northeast \
    --region us-west-2

此命令不會產生輸出。

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

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

AWS CLI

從資源中移除標籤

下列untag-resource範例Network會從裝置 移除具有 金鑰的標籤device-07f6fd08867abc123。

aws networkmanager untag-resource \
    --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 ]
    --tag-keys Network \
    --region us-west-2

此命令不會產生輸出。

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

下列程式碼範例示範如何使用 update-device。

AWS CLI

若要更新裝置

下列update-device範例device-07f6fd08867abc123會透過指定裝置的網站 ID 來更新裝置。

aws networkmanager update-device \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --site-id site-444555aaabbb11223 \
    --region us-west-2

輸出：

{
    "Device": {
        "DeviceId": "device-07f6fd08867abc123",
        "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "NY office device",
        "Type": "Office device",
        "Vendor": "anycompany",
        "Model": "abcabc",
        "SerialNumber": "1234",
        "SiteId": "site-444555aaabbb11223",
        "CreatedAt": 1575554005.0,
        "State": "UPDATING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用 裝置。

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

下列程式碼範例示範如何使用 update-global-network。

AWS CLI

更新全域網路

下列update-global-network範例會更新全域網路 的描述global-network-01231231231231231。

aws networkmanager update-global-network \
    --global-network-id global-network-01231231231231231 \
    --description "Head offices" \
    --region us-west-2

輸出：

{
    "GlobalNetwork": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231",
        "Description": "Head offices",
        "CreatedAt": 1575553525.0,
        "State": "UPDATING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的 Global Networks。

下列程式碼範例示範如何使用 update-link。

AWS CLI

更新連結

下列update-link範例會更新連結 的頻寬資訊link-11112222aaaabbbb1。

aws networkmanager update-link \
    --global-network-id global-network-01231231231231231 \
    --link-id link-11112222aaaabbbb1 \
    --bandwidth  UploadSpeed=20,DownloadSpeed=20 \
    --region us-west-2

輸出：

{
    "Link": {
        "LinkId": "link-11112222aaaabbbb1",
        "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
        "GlobalNetworkId": "global-network-01231231231231231",
        "SiteId": "site-444555aaabbb11223",
        "Description": "VPN Link",
        "Type": "broadband",
        "Bandwidth": {
            "UploadSpeed": 20,
            "DownloadSpeed": 20
        },
        "Provider": "AnyCompany",
        "CreatedAt": 1575555811.0,
        "State": "UPDATING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用連結。

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

下列程式碼範例示範如何使用 update-site。

AWS CLI

更新網站

下列update-site範例會更新指定全域網路site-444555aaabbb11223中站台的描述。

aws networkmanager update-site \
    --global-network-id global-network-01231231231231231 \
    --site-id site-444555aaabbb11223 \
    --description "New York Office site" \
    --region us-west-2

輸出：

{
    "Site": {
        "SiteId": "site-444555aaabbb11223",
        "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York Office site",
        "Location": {
            "Latitude": "40.7128",
            "Longitude": "-74.0060"
        },
        "CreatedAt": 1575554528.0,
        "State": "UPDATING"
    }
}

如需詳細資訊，請參閱 Transit Gateway Network Manager 指南中的使用網站。

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