Ejemplos de Resource Explorer que utilizan la AWS CLI - AWS Command Line Interface
Acciones

Ejemplos de Resource Explorer que utilizan la AWS CLI

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando la AWS Command Line Interface con Resource Explorer.

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.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar associate-default-view.

AWS CLI

Para configurar una vista de Resource Explorer como predeterminada para su región de AWS

El siguiente ejemplo de associate-default-view establece una vista, según lo especificado por su ARN, como la vista predeterminada de la región de AWS en la que se llama a la operación.

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

Salida:

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

Para obtener más información, consulte Setting a default view in an AWS Region en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte AssociateDefaultView en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar batch-get-view.

AWS CLI

Para recuperar detalles sobre varias vistas del Resource Explorer

En el siguiente ejemplo de batch-get-view, se muestran los detalles de dos vistas especificadas por sus ARN. Utilice espacios para separar los múltiples ARN en el parámetro --view-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

Salida:

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

Para obtener más información sobre las vistas, consulte About Resource Explorer views en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información de la API, consulte BatchGetView en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-index.

AWS CLI

Para activar Resource Explorer en una región de AWS al crear un índice

El siguiente ejemplo de create-index crea un índice local en la región de AWS en la que se llama a la operación. La CLI de AWS genera automáticamente un valor de parámetro client-token aleatorio y lo incluye en la llamada a AWS si no se especifica un valor.

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

Salida:

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

Tras crear un índice local, puede convertirlo en el índice agregador de la cuenta ejecutando el comando update-index-type.

Para más información, consulte Turning on Resource Explorer in an AWS Region to index your resources en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte CreateIndex en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-view.

AWS CLI

Ejemplo 1: crear una vista sin filtrar del índice de una región de AWS

El siguiente ejemplo de create-view crea una vista en la región de AWS especificada que devuelve todos los resultados de la región sin ningún tipo de filtrado. La vista incluye el campo Tags opcional en los resultados devueltos. Como esta vista se crea en la región que contiene el índice agregador, puede incluir los resultados de todas las regiones de la cuenta que contienen un índice de Resource Explorer.

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

Salida:

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

Ejemplo 2: crear una vista que devuelva solo los recursos asociados a Amazon EC2

Este create-view crea una vista en la región de AWS us-east-1 que devuelve solo los recursos de la región que están asociados al servicio de Amazon EC2. La vista incluye el campo Tags opcional en los resultados devueltos. Como esta vista se crea en la región que contiene el índice agregador, puede incluir los resultados de todas las regiones de la cuenta que contienen un índice de 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

Salida:

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

Para obtener más información, consulte Creating views for search en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte CreateView en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-index.

AWS CLI

Para desactivar Resource Explorer en una región de AWS eliminando su índice

En el siguiente ejemplo de delete-index, se elimina el índice de Resource Explorer especificado en la región de AWS en la que se realiza la solicitud.

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

Salida:

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

Para más información, consulte Turning off AWS Resource Explorer in an AWS Region en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte DeleteIndex en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-view.

AWS CLI

Para eliminar una vista de Resource Explorer

En el siguiente ejemplo de delete-view, se elimina una vista especificada por su 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

Salida:

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

Para obtener más información, consulte Deleting views en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte DeleteView en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar disassociate-default-view.

AWS CLI

Para eliminar la vista predeterminada de Resource Explorer de una región de AWS

Este disassociate-default-view elimina la vista predeterminada de Resource Explorer de la región de AWS en la que se llama a la operación. Tras realizar esta operación, todas las operaciones de búsqueda de la región deben especificar explícitamente una vista; de lo contrario, la operación fallará.

aws resource-explorer-2 disassociate-default-view

Este comando no genera ninguna salida.

Para obtener más información, consulte Setting a default view in an AWS Region en la Guía del usuario de AWS Resource Explorer.

  • Para obtener más información sobre la API, consulte DisassociateDefaultView en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-default-view.

AWS CLI

Para recuperar una vista de Resource Explorer como predeterminada para su región de AWS

El siguiente ejemplo de get-default-view recupera el ARN de la vista que es la predeterminada para la región AWS desde la que llamó a la operación.

aws resource-explorer-2 get-default-view

Salida:

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

Para obtener más información, consulte Setting a default view in an AWS Region en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte GetDefaultView en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-index.

AWS CLI

Ejemplo 1: recuperar los detalles de un índice agregador de Resource Explorer

En el siguiente ejemplo de get-index, se muestran los detalles del índice de Resource Explorer en la región de AWS especificada. Como la región especificada contiene el índice agregador de la cuenta, el resultado enumera las regiones que replican los datos en el índice de esta región.

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

Salida:

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

Ejemplo 2: recuperar los detalles de un índice local de Resource Explorer

En el siguiente ejemplo de get-index, se muestran los detalles del índice de Resource Explorer en la región de AWS especificada. Como la región especificada contiene un índice local, el resultado muestra la región en la que se replican los datos del índice de esta región.

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

Salida:

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

Para obtener más información sobre los índices, consulte Checking which AWS Regions have Resource Explorer turned on en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte GetIndex en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-view.

AWS CLI

Para recuperar detalles sobre una vista del Resource Explorer

En el siguiente ejemplo de get-view, se muestran los detalles sobre una vista especificada por sus 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

Salida:

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

Para obtener más información sobre las vistas, consulte About Resource Explorer views en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte GetView en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-indexes.

AWS CLI

Para enumerar las regiones de AWS en las que Resource Explorer tiene índices

El siguiente ejemplo de list-indexes muestra los índices de todas las regiones en las que Resource Explorer tiene un índice. La respuesta especifica el tipo de cada índice, su región de AWS y su ARN.

aws resource-explorer-2 list-indexes

Salida:

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

Para obtener más información sobre los índices, consulte Checking which AWS Regions have Resource Explorer turned on en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte ListIndexes en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-supported-resource-types.

AWS CLI

Para enumerar las regiones de AWS en las que Resource Explorer tiene índices

En el siguiente ejemplo de list-supported-resource-types, se enumeran todos los tipos de recursos que actualmente admite &AREXlong;. La respuesta de ejemplo incluye un valor NextToken que indica que hay más resultados disponibles para recuperar con llamadas adicionales.

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

Salida:

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

Para obtener la siguiente parte del resultado, vuelva a llamar a la operación y use el valor de respuesta NextToken de la llamada anterior como el valor de --starting-token. Repita el procedimiento hasta que NextToken no aparezca en la respuesta.

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

Salida:

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

Para obtener más información sobre los índices, consulte Checking which AWS Regions have Resource Explorer turned on en la Guía del usuario de AWS Resource Explorer.

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource.

AWS CLI

Para enumerar las etiquetas adjuntas a una vista o índice de Resource Explorer

En el siguiente ejemplo de list-tags-for-resource, se enumeran los pares de clave y valor asociados a la vista con el ARN especificado. Debe llamar a la operación desde la región de AWS que contiene el recurso.

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

Salida:

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

Para obtener más información sobre el etiquetado de vistas, consulte Tagging views for access control en la Guía del usuario del AWS Resource Explorer.

  • 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 list-views.

AWS CLI

Para enumerar las vistas de Resource Explorer que están disponibles en una región de AWS

En el siguiente ejemplo de list-views, se enumeran todas las vistas disponibles en la región en la que se invoca la operación.

aws resource-explorer-2 list-views

Salida:

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

Para obtener más información sobre las vistas, consulte About Resource Explorer views en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte ListViews en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar search.

AWS CLI

Ejemplo 1: buscar mediante la vista predeterminada

En el siguiente ejemplo de search, se muestran todos los recursos asociados con el servicio. La búsqueda utiliza la vista predeterminada para la región. La respuesta de ejemplo incluye un valor NextToken que indica que hay más resultados disponibles para recuperar con llamadas adicionales.

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

Salida:

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

Ejemplo 2: buscar mediante una vista específica

El siguiente ejemplo de search de búsqueda muestra todos los recursos (*) de la región de AWS especificada que están visibles a través de la vista especificada. Los resultados incluyen solo los recursos asociados a Amazon EC2 debido a los filtros adjuntos a la vista.

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

Salida:

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

Para obtener más información, consulte Using AWS Resource Explorer to search for resources en la Guía de recursos de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte Search 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 eliminar una vista de Resource Explorer

En el siguiente ejemplo de tag-resource, se agrega la clave de etiqueta environment con el valor production a la vista con el ARN especificado.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Tagging views for access control en la Guía del usuario de AWS Resource Explorer.

  • 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 una vista de Resource Explorer

El siguiente ejemplo de untag-resource elimina las etiquetas con la nombre de clave environment de la vista con el ARN especificado.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Tagging views for access control en la Guía del usuario de AWS Resource Explorer.

  • Para ver los detalles de la API, consulte UntagResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-index-type.

AWS CLI

Para cambiar el tipo de índice de Resource Explorer

En el siguiente ejemplo de update-index-type, se convierte el índice especificado de un tipo local a otro tipo aggregator para activar la posibilidad de buscar recursos en todas las regiones de AWS de la cuenta. Debe enviar la solicitud a la región de AWS que contiene el índice que desea actualizar.

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

Salida:

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

Para obtener información sobre cambiar un tipo de índice, consulte Turning on cross-Region search by creating an aggregator index en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte UpdateIndexType en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-view.

AWS CLI

Ejemplo 1: actualizar el campo IncludedProperties para una vista de Resource Explorer

En el siguiente ejemplo de update-view, se actualiza la vista especificada agregando `tags` a la opcional `IncludedProperties`. Tras ejecutar esta operación, las operaciones de búsqueda que utilizan esta vista incluyen información sobre las etiquetas asociadas a los recursos que aparecen en los resultados.

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

Salida:

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

Ejemplo 2: actualizar los filtros adjuntos a una vista

En el siguiente ejemplo de update-view, se actualiza la vista especificada para utilizar un filtro que limite los resultados únicamente a los tipos de recursos asociados al servicio 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

Salida:

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

Para obtener más información sobre las vistas, consulte About Resource Explorer views en la Guía del usuario de AWS Resource Explorer.

  • Para obtener información sobre la API, consulte UpdateView en la Referencia de comandos de la AWS CLI.