資源瀏覽器示例使用 AWS CLI - AWS Command Line Interface

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

資源瀏覽器示例使用 AWS CLI

下列程式碼範例會示範如何使用 AWS Command Line Interface 與資源總管搭配使用來執行動作及實作常見案例。

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

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

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

主題

動作

下列程式碼範例會示範如何使用associate-default-view

AWS CLI

若要將資源總管檢視設定為其 [ AWS 區域] 的預設值

下列associate-default-view範例會將檢視 (如其 ARN 所指定) 設定為您呼叫作業之「區域」( AWS Region) 的預設檢視表。

aws resource-explorer-2 associate-default-view \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

輸出:

{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

如需詳細資訊,請參閱《AWS 資源總管使用者指南》中的〈在 AWS 區域中設定預設檢視

下列程式碼範例會示範如何使用batch-get-view

AWS CLI

擷取有關多個資源總管檢視的詳細資料

下列batch-get-view範例會顯示兩個由 ARN 指定的檢視的詳細資料。使用空格來分隔--view arn 參數中的多個 ARN。

aws resource-explorer-2 batch-get-view \ --view-arns arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222, \ arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

輸出:

{ "Views": [ { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T21:33:45.249000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" }, { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } ] "Errors": [] }

如需有關檢視的詳細資訊,請參閱《資源總管使用者指南》中的關於AWS 資源總管檢視

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

下列程式碼範例會示範如何使用create-index

AWS CLI

透過建立索引來開啟 AWS 區域中的資源總管

下列create-index範例會在呼叫作業的 [ AWS 區域] 中建立區域索引。 AWS CLI 會自動產生隨機client-token參數值, AWS 如果您未指定值,則會將其包含在呼叫中。

aws resource-explorer-2 create-index \ --region us-east-1

輸出:

{ "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222c", "CreatedAt": "2022-11-01T20:00:59.149Z", "State": "CREATING" }

建立本機索引之後,您可以透過執行update-index-type命令將其轉換為帳戶的彙總索引。

如需詳細資訊,請參閱《資源總管使用者指南》中的〈開啟 AWS 區域中的資AWS 源總管〉以建立資源索引。

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

下列程式碼範例會示範如何使用create-view

AWS CLI

範例 1:為區域中的索引建立未篩選的檢視 AWS

下列create-view範例會在指定的 Region 中建立檢視,該檢視會傳回 AWS Region 中的所有結果,而不進行任何篩選。檢視會在傳回的結果上包含選用的「標籤」欄位。由於此檢視是在包含彙總器索引的「區域」中建立的,因此可以在包含資源總管索引的帳戶中包含所有區域的結果。

aws resource-explorer-2 create-view \ --view-name My-Main-View \ --included-properties Name=tags \ --region us-east-1

輸出:

{ "View": { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }

範例 2:若要建立僅傳回與 Amazon EC2 相關聯之資源的檢視

以下內容在 AWS 區域中create-view建立一個檢視,us-east-1該檢視僅傳回與 Amazon EC2 服務相關聯的區域中的那些資源。該視圖包括返回結果的可選Tags字段。由於此檢視是在包含彙總器索引的「區域」中建立的,因此可以在包含資源總管索引的帳戶中包含所有區域的結果。

aws resource-explorer-2 create-view \ --view-name My-EC2-Only-View \ --included-properties Name=tags \ --filters FilterString="service:ec2" \ --region us-east-1

輸出:

{ "View": { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [ { "Name":"tags" } ], "LastUpdatedAt": "2022-07-13T21:35:09.059Z", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" } }

如需詳細資訊,請參閱《AWS 資源總管使用指南》中的〈建立檢視以進行搜尋

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

下列程式碼範例會示範如何使用delete-index

AWS CLI

透過刪除某個 AWS 區域的索引來關閉「資源總管」的步驟

下列delete-index範例會刪除您提出要求之「 AWS 區域」中指定的「資源總管」索引。

aws resource-explorer-2 delete-index \ --arn arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222 \ --region us-west-2

輸出:

{ "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "State": "DELETING" }

如需有關刪除索引的詳細資訊,請參閱《AWS 資源總管使用者指南》中的〈關閉 AWS 區域中的AWS 資源總管〉

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

下列程式碼範例會示範如何使用delete-view

AWS CLI

刪除資源總管檢視的步驟

下列delete-view範例會刪除其 ARN 所指定的檢視表。

aws resource-explorer-2 delete-view \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

輸出:

{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

如需詳細資訊,請參閱《AWS 資源總管使用指南》中的〈刪除檢視

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

下列程式碼範例會示範如何使用disassociate-default-view

AWS CLI

若要移除 AWS 區域的預設資源總管檢視

以下內容disassociate-default-view會移除您呼叫作業之「 AWS 區域」的預設「資源總管」檢視。執行此操作後,「區域」中的所有搜索操作都必須明確指定視圖,否則操作會失敗。

aws resource-explorer-2 disassociate-default-view

此命令不會產生輸出。

如需詳細資訊,請參閱《AWS 資源總管使用者指南》中的〈在 AWS 區域中設定預設檢視

下列程式碼範例會示範如何使用get-default-view

AWS CLI

若要擷取作為其 [ AWS 區域] 預設檢視的 [資源總管] 檢視

下列get-default-view範例會擷取您呼叫作業之 [ AWS Region] (區域) 預設檢視的 ARN。

aws resource-explorer-2 get-default-view

輸出:

{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

如需詳細資訊,請參閱《AWS 資源總管使用者指南》中的〈在 AWS 區域中設定預設檢視

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

下列程式碼範例會示範如何使用get-index

AWS CLI

範例 1:若要擷取資源總管彙總器索引的詳細資料

下列get-index範例會顯示指定「 AWS 區域」中「資源總管」索引的詳細資料。由於指定的「區域」包含帳戶的彙總索引,因此輸出會列出將資料複製到此「區域」索引的「區域」。

aws resource-explorer-2 get-index \ --region us-east-1

輸出:

{ "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "CreatedAt": "2022-07-12T18:59:10.503000+00:00", "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00", "ReplicatingFrom": [ "ap-south-1", "us-west-2" ], "State": "ACTIVE", "Tags": {}, "Type": "AGGREGATOR" }

範例 2:擷取資源總管本機索引的詳細資料

下列get-index範例會顯示指定「 AWS 區域」中「資源總管」索引的詳細資料。因為指定的 Region 包含本機索引,所以輸出會列出從此區域索引複寫資料的「區域」。

aws resource-explorer-2 get-index \ --region us-west-2

輸出:

{ "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "CreatedAt": "2022-07-12T18:59:10.503000+00:00", "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00", "ReplicatingTo": [ "us-west-2" ], "State": "ACTIVE", "Tags": {}, "Type": "LOCAL" }

如需索引的詳細資訊,請參閱《資源總管使用者指南》中的「檢查哪些 AWS 區域已開啟AWS資源總管」。

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

下列程式碼範例會示範如何使用get-view

AWS CLI

若要擷取有關資源總管檢視的詳細資訊

下列get-view範例會顯示其 ARN 所指定之檢視的詳細資料。

aws resource-explorer-2 get-view \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

輸出:

{ "Tags" : {}, "View" : { "Filters" : { "FilterString" : "service:ec2" }, "IncludedProperties" : [ { "Name" : "tags" } ], "LastUpdatedAt" : "2022-07-13T21:33:45.249Z", "Owner" : "123456789012", "Scope" : "arn:aws:iam::123456789012:root", "ViewArn" : "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }

如需有關檢視的詳細資訊,請參閱《資源總管使用者指南》中的關於AWS 資源總管檢視

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

下列程式碼範例會示範如何使用list-indexes

AWS CLI

列出「資源總管」具有索引的 AWS 區域

下列list-indexes範例會列出「資源總管」具有索引之所有區域的索引。回應會指定每個索引、其 AWS 區域及其 ARN 的類型。

aws resource-explorer-2 list-indexes

輸出:

{ "Indexes": [ { "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "Region": "us-west-2", "Type": "AGGREGATOR" }, { "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "Region": "us-east-1", "Type": "LOCAL" }, { "Arn": "arn:aws:resource-explorer-2:us-east-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333", "Region": "us-east-2", "Type": "LOCAL" }, { "Arn": "arn:aws:resource-explorer-2:us-west-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE44444", "Region": "us-west-1", "Type": "LOCAL" } ] }

如需索引的詳細資訊,請參閱《資源總管使用者指南》中的「檢查哪些 AWS 區域已開啟AWS資源總管」。

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

下列程式碼範例會示範如何使用list-supported-resource-types

AWS CLI

列出「資源總管」具有索引的 AWS 區域

以下list-supported-resource-types示例列出了 &arexlong; 当前支持的所有资源类型。範例回應包含一個NextToken值,表示有更多輸出可用於透過其他呼叫擷取。

aws resource-explorer-2 list-supported-resource-types \ --max-items 10

輸出:

{ "ResourceTypes": [ { "ResourceType": "cloudfront:cache-policy", "Service": "cloudfront" }, { "ResourceType": "cloudfront:distribution", "Service": "cloudfront" }, { "ResourceType": "cloudfront:function", "Service": "cloudfront" }, { "ResourceType": "cloudfront:origin-access-identity", "Service": "cloudfront" }, { "ResourceType": "cloudfront:origin-request-policy", "Service": "cloudfront" }, { "ResourceType": "cloudfront:realtime-log-config", "Service": "cloudfront" }, { "ResourceType": "cloudfront:response-headers-policy", "Service": "cloudfront" }, { "ResourceType": "cloudwatch:alarm", "Service": "cloudwatch" }, { "ResourceType": "cloudwatch:dashboard", "Service": "cloudwatch" }, { "ResourceType": "cloudwatch:insight-rule", "Service": "cloudwatch" } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=" }

若要取得輸出的下一部分,請再次呼叫作業,並傳遞上一個呼叫的NextToken回應值做為的值--starting-token。重複直到NextToken響應中不存在。

aws resource-explorer-2 list-supported-resource-types \ --max-items 10 \ --starting-token eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=

輸出:

{ "ResourceTypes": [ { "ResourceType": "cloudwatch:metric-stream", "Service": "cloudwatch" }, { "ResourceType": "dynamodb:table", "Service": "dynamodb" }, { "ResourceType": "ec2:capacity-reservation", "Service": "ec2" }, { "ResourceType": "ec2:capacity-reservation-fleet", "Service": "ec2" }, { "ResourceType": "ec2:client-vpn-endpoint", "Service": "ec2" }, { "ResourceType": "ec2:customer-gateway", "Service": "ec2" }, { "ResourceType": "ec2:dedicated-host", "Service": "ec2" }, { "ResourceType": "ec2:dhcp-options", "Service": "ec2" }, { "ResourceType": "ec2:egress-only-internet-gateway", "Service": "ec2" }, { "ResourceType": "ec2:elastic-gpu", "Service": "ec2" } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyMH0=" }

如需索引的詳細資訊,請參閱《資源總管使用者指南》中的「檢查哪些 AWS 區域已開啟AWS資源總管」。

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

AWS CLI

列出附加至資源總管檢視或索引的標籤

下列list-tags-for-resource範例會列出附加至具有指定 ARN 之檢視的標籤鍵和值配對。您必須從包含資源的 AWS 區域呼叫作業。

aws resource-explorer-2 list-tags-for-resource \ --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111

輸出:

{ "Tags": { "application": "MainCorpApp", "department": "1234" } }

如需有關為檢視加上標籤的詳細資訊,請參閱《AWS 資源總管使用者指南》中的〈為檢視加上標籤

下列程式碼範例會示範如何使用list-views

AWS CLI

列出 AWS 區域中可用的資源總管檢視

下列list-views範例會列出您呼叫作業之「區域」中所有可用的檢視表。

aws resource-explorer-2 list-views

輸出:

{ "Views": [ "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Default-All-Resources-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Production-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333" ] }

如需有關檢視的詳細資訊,請參閱《資源總管使用者指南》中的關於AWS 資源總管檢視

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

下列程式碼範例會示範如何使用search

AWS CLI

範例 1:若要使用預設檢視表進行搜尋

下列search範例會顯示指定中與服務相關聯的所有資源。搜尋會使用「地區」的預設檢視表。範例回應包含一個NextToken值,表示有更多輸出可用於透過其他呼叫擷取。

aws resource-explorer-2 search \ --query-string "service:iam"

輸出:

{ "Count": { "Complete": true, "TotalResources": 55 }, "NextToken": "AG9VOEF1KLEXAMPLEOhJHVwo5chEXAMPLER5XiEpNrgsEXAMPLE...b0CmOFOryHEXAMPLE", "Resources": [{ "Arn": "arn:aws:iam::123456789012:policy/service-role/Some-Policy-For-A-Service-Role", "LastReportedAt": "2022-07-21T12:34:42Z", "OwningAccountId": "123456789012", "Properties": [], "Region": "global", "ResourceType": "iam:policy", "Service": "iam" }, { "Arn": "arn:aws:iam::123456789012:policy/service-role/Another-Policy-For-A-Service-Role", "LastReportedAt": "2022-07-21T12:34:42Z", "OwningAccountId": "123456789012", "Properties": [], "Region": "global", "ResourceType": "iam:policy", "Service": "iam" }, { ... TRUNCATED FOR BREVITY ... }], "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/my-default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }

範例 2:若要使用指定的檢視表進行搜尋

下列search範例搜尋會顯示可透過指定檢視顯示的指定 AWS 區域中的所有資源 (「*」)。結果僅包含與 Amazon EC2 相關聯的資源,因為檢視上附加了篩選器。

aws resource-explorer-2 search \ -- query-string "*" \ -- view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

輸出:

HTTP/1.1 200 OK Date: Tue, 01 Nov 2022 20:00:59 GMT Content-Type: application/json Content-Length: <PayloadSizeBytes> { "Count": { "Complete": true, "TotalResources": 67 }, "Resources": [{ "Arn": "arn:aws:ec2:us-east-1:123456789012:network-acl/acl-1a2b3c4d", "LastReportedAt": "2022-07-21T18:52:02Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-11-15T14:48:29Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:network-acl", "Service": "ec2" }, { "Arn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-1a2b3c4d", "LastReportedAt": "2022-07-21T21:22:23Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-07-29T19:02:39Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:subnet", "Service": "ec2" }, { "Arn": "arn:aws:ec2:us-east-1:123456789012:dhcp-options/dopt-1a2b3c4d", "LastReportedAt": "2022-07-21T06:08:53Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-11-15T15:11:05Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:dhcpoptions", "Service": "ec2" }, { ... TRUNCATED FOR BREVITY ... }], "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" }

如需詳細資訊,請參閱《AWS 資源總管使用者指南》中的〈使用AWS 資源總管搜尋資源〉

  • 如需 API 詳細資訊,請參閱在AWS CLI 命令參考搜尋

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

AWS CLI

為資源總管檢視加上標籤

下列tag-resource範例會將值為「生產」的標籤索引鍵「環境」新增至具有指定 ARN 的檢視。

aws resource-explorer-2 tag-resource \ --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \ --tags environment=production

此命令不會產生輸出。

如需詳細資訊,請參閱《AWS 資源總管使用者指南》中的為存取控制標籤檢視

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

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

AWS CLI

若要從資源總管檢視中移除標籤

下列untag-resource範例會從具有指定 ARN 的檢視中移除索引鍵名稱為「環境」的任何標籤。

aws resource-explorer-2 untag-resource \ --resource-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \ --tag-keys environment

此命令不會產生輸出。

如需詳細資訊,請參閱《AWS 資源總管使用者指南》中的為存取控制標籤檢視

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

下列程式碼範例會示範如何使用update-index-type

AWS CLI

變更資源總管索引類型的步驟

下列update-index-type範例會將指定的索引從類型local轉換aggregator為類型,以開啟在帳戶中所有 AWS 區域中搜尋資源的功能。您必須將請求發送到包含要更新索引的 AWS 區域。

aws resource-explorer-2 update-index-type \ --arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \ --type aggregator \ --region us-east-1

輸出:

{ "Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "LastUpdatedAt":"2022-07-13T18:41:58.799Z", "State":"updating", "Type":"aggregator" }

如需有關變更索引類型的詳細資訊,請參閱《AWS 資源總管使用者指南》中的 < 透過建立彙總器索引來開啟跨區域搜尋 >。

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

下列程式碼範例會示範如何使用update-view

AWS CLI

範例 1:若要更新 [資源總管] 檢視的 IncludedProperties 欄位

下列update-view範例會透過新增`tags`至選用項目來更新指定的檢視表`IncludedProperties`。執行此作業之後,使用此檢視的搜尋作業會包含附加至結果中顯示之資源之標籤的相關資訊。

aws resource-explorer-2 update-view \ --included-properties Name=tags \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

輸出:

{ "View": { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }

範例 2:更新附加至檢視的篩選

下列update-view範例將指定的檢視更新為使用篩選器,該篩選器將結果限制為僅與 Amazon EC2 服務相關聯的資源類型。

aws resource-explorer-2 update-view \ --filters FilterString="service:ec2" \ --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

輸出:

{ "View": { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [], "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" } }

如需有關檢視的詳細資訊,請參閱《資源總管使用者指南》中的關於AWS 資源總管檢視

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