를 사용한 Resource Explorer 예제 AWS CLI - AWS Command Line Interface
작업

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용한 Resource Explorer 예제 AWS CLI

다음 코드 예제에서는 Resource Explorer AWS Command Line Interface 에서 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 associate-default-view을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer 뷰를 해당 AWS 리전의 기본값으로 설정하려면

다음 associate-default-view 예제에서는 에 지정된 뷰를 작업을 호출하는 AWS 리전의 ARN기본 뷰로 설정합니다.

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 Resource Explorer 사용 설명서의 AWS 리전에서 기본 보기 설정을 참조하세요.

다음 코드 예시에서는 batch-get-view을 사용하는 방법을 보여 줍니다.

AWS CLI

여러 Resource Explorer 뷰에 대한 세부 정보를 검색하려면

다음 batch-get-view 예제에서는 에서 지정한 두 뷰에 대한 세부 정보를 표시합니다ARNs. 공백을 사용하여 --view-arn 파라미터ARNs의 다중 를 구분합니다.

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": []
}

뷰에 대한 자세한 내용은 Resource Explorer 사용 설명서의 Resource Explorer 뷰 정보를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조BatchGetView의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-index을 사용하는 방법을 보여 줍니다.

AWS CLI

인덱스를 생성하여 AWS 리전에서 Resource Explorer를 켜려면

다음 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 명령을 실행하여 계정의 애그리게이터 인덱스로 변환할 수 있습니다.

자세한 내용은 Resource Explorer 사용 설명서의 리소스 인덱싱을 위해 AWS 리전에서 Resource Explorer 켜기를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조CreateIndex의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-view을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: AWS 리전의 인덱스에 대해 필터링되지 않은 뷰를 생성하려면

다음 create-view 예제에서는 지정된 AWS 리전에 필터링 없이 리전의 모든 결과를 반환하는 뷰를 생성합니다. 뷰에는 반환된 결과에 대한 선택적 태그 필드가 포함됩니다. 이 보기는 집계자 인덱스가 포함된 리전에서 생성되므로 Resource Explorer 인덱스가 포함된 계정의 모든 리전의 결과를 포함할 수 있습니다.

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

다음은 Amazon EC2 서비스와 연결된 AWS 리전의 리소스만 us-east-1 반환하는 보기를 리전에 create-view 생성합니다. 뷰에는 반환된 결과에 대한 선택적 Tags 필드가 포함됩니다. 이 보기는 집계자 인덱스가 포함된 리전에서 생성되므로 Resource Explorer 인덱스가 포함된 계정의 모든 리전의 결과를 포함할 수 있습니다.

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 Resource Explorer 사용 설명서의 검색을 위한 뷰 생성을 참조하세요.

  • 자세한 API 내용은 명령 참조CreateView의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-index을 사용하는 방법을 보여 줍니다.

AWS CLI

인덱스를 삭제하여 AWS 리전에서 Resource Explorer를 끄려면

다음 delete-index 예제에서는 요청을 수행하는 AWS 리전에서 지정된 Resource Explorer 인덱스를 삭제합니다.

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 Resource Explorer 사용 설명서의 AWS 리전에서 Resource Explorer 끄기를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조DeleteIndex의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-view을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer 보기를 삭제하려면

다음 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 Resource Explorer 사용 설명서의 보기 삭제를 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteView의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 disassociate-default-view을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 리전에 대한 기본 Resource Explorer 보기를 제거하려면

다음은 작업을 호출하는 AWS 리전의 기본 Resource Explorer 보기를 disassociate-default-view 제거합니다. 이 작업을 수행한 후 리전의 모든 검색 작업은 뷰를 명시적으로 지정해야 합니다. 그렇지 않으면 작업이 실패합니다.

aws resource-explorer-2 disassociate-default-view

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS Resource Explorer 사용 설명서의 AWS 리전에서 기본 보기 설정을 참조하세요.

다음 코드 예시에서는 get-default-view을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 해당 리전의 기본 뷰인 Resource Explorer 뷰를 검색하려면

다음 get-default-view 예제에서는 작업을 호출하는 AWS 리전의 기본값인 뷰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 Resource Explorer 사용 설명서의 AWS 리전에서 기본 보기 설정을 참조하세요.

  • 자세한 API 내용은 명령 참조GetDefaultView의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-index을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: Resource Explorer 애그리게이터 인덱스의 세부 정보를 검색하려면

다음 get-index 예제에서는 지정된 AWS 리전의 Resource Explorer 인덱스에 대한 세부 정보를 표시합니다. 지정된 리전에는 계정의 집계기 인덱스가 포함되어 있으므로 출력에는 이 리전의 인덱스에 데이터를 복제하는 리전이 나열됩니다.

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: Resource Explorer 로컬 인덱스에 대한 세부 정보를 검색하려면

다음 get-index 예제에서는 지정된 AWS 리전의 Resource Explorer 인덱스에 대한 세부 정보를 표시합니다. 지정된 리전에는 로컬 인덱스가 포함되어 있으므로 출력에는 이 리전의 인덱스에서 데이터를 복제하는 리전이 나열됩니다.

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

인덱스에 대한 자세한 내용은 Resource Explorer 사용 설명서의 Resource Explorer가 켜져 있는 AWS 리전 확인을 참조하세요. AWS

  • 자세한 API 내용은 명령 참조GetIndex의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-view을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer 뷰에 대한 세부 정보를 검색하려면

다음 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"
  }
}

뷰에 대한 자세한 내용은 Resource Explorer 사용 설명서의 Resource Explorer 뷰 정보를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조GetView의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-indexes을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer에 인덱스가 있는 AWS 리전을 나열하려면

다음 list-indexes 예제에서는 Resource Explorer에 인덱스가 있는 모든 리전의 인덱스를 나열합니다. 응답은 각 인덱스의 유형, 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"
        }
    ]
}

인덱스에 대한 자세한 내용은 Resource Explorer 사용 설명서의 Resource Explorer가 켜져 있는 AWS 리전 확인을 참조하세요. AWS

  • 자세한 API 내용은 명령 참조ListIndexes의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-supported-resource-types을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer에 인덱스가 있는 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="
}

인덱스에 대한 자세한 내용은 Resource Explorer 사용 설명서의 Resource Explorer가 켜져 있는 AWS 리전 확인을 참조하세요. AWS

다음 코드 예시에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer 뷰 또는 인덱스에 연결된 태그를 나열하려면

다음 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 Resource Explorer 사용 설명서의 액세스 제어를 위한 뷰 태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-views을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 리전에서 사용할 수 있는 Resource Explorer 뷰를 나열하려면

다음 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"
    ]
}

뷰에 대한 자세한 내용은 Resource Explorer 사용 설명서의 Resource Explorer 뷰 정보를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조ListViews의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 리전의 모든 리소스(“*”)를 표시합니다. 결과에는 뷰에 연결된 필터로 EC2 인해 Amazon과 연결된 리소스만 포함됩니다.

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 Resource Explorer 사용 설명서의 Resource Explorer를 사용하여 리소스를 검색하기를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조의 검색을 참조하세요. AWS CLI

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer 뷰에 태그를 지정하려면

다음 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 Resource Explorer 사용 설명서의 액세스 제어를 위한 뷰 태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer 보기에서 태그를 제거하려면

다음 untag-resource 예제에서는 키 이름이 'environment'인 태그를 지정된 가 있는 뷰에서 제거합니다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 Resource Explorer 사용 설명서의 액세스 제어를 위한 뷰 태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-index-type을 사용하는 방법을 보여 줍니다.

AWS CLI

Resource Explorer 인덱스의 유형을 변경하려면

다음 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 Resource Explorer 사용 설명서의 애그리게이터 인덱스를 생성하여 리전 간 검색 켜기를 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateIndexType의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-view을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: Resource Explorer 보기의 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"
    }
}

뷰에 대한 자세한 내용은 Resource Explorer 사용 설명서의 Resource Explorer 뷰 정보를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조UpdateView의 섹션을 참조하세요. AWS CLI