View a markdown version of this page

Ejemplos de detectives que utilizan AWS CLI - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el repositorio de ejemplos de AWS Doc SDK. GitHub

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de detectives que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de AWS Command Line Interface Detective.

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 accept-invitation.

AWS CLI

Aceptación de una invitación para ser una cuenta miembro de un gráfico de comportamiento

En el siguiente ejemplo de accept-invitation, se acepta una invitación para convertirse en una cuenta miembro de un gráfico de comportamiento arn:aws:detective:us-east- 1:111122223333:graph:123412341234.

aws detective accept-invitation \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Este comando no genera ninguna salida.

Para obtener más información, consulte Responding to a behavior graph invitation en la Guía de administración de Amazon Detective.

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

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

AWS CLI

Activación de Amazon Detective y creación de un nuevo gráfico de comportamiento

El siguiente create-graph ejemplo habilita a Detective para la AWS cuenta que ejecuta el comando en la región en la que se ejecuta el comando. Se crea un nuevo gráfico de comportamiento que tiene esa cuenta como cuenta de administrador. El comando también asigna el valor Finance a la etiqueta Department.

aws detective create-graph \
    --tags '{"Department": "Finance"}'

Salida:

{
    "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"
}

Para obtener más información, consulte Enabling Amazon Detective en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte CreateGraph la referencia de AWS CLI comandos.

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

AWS CLI

Invitación de cuentas de miembros a un gráfico de comportamiento

En el siguiente create-members ejemplo, se invita a dos AWS cuentas a convertirse en cuentas de miembros en el gráfico de comportamiento arn:aws:detective:us-east- 1:111122223333:graph:123412341234. Para cada cuenta, la solicitud proporciona el identificador de la cuenta y la dirección de correo electrónico del usuario raíz de la cuenta. AWS La solicitud incluye un mensaje personalizado para insertarlo en el correo electrónico de invitación.

aws detective create-members \
    --accounts AccountId=444455556666,EmailAddress=mmajor@example.com AccountId=123456789012,EmailAddress=jstiles@example.com \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --message "This is Paul Santos. I need to add your account to the data we use for security investigation in Amazon Detective. If you have any questions, contact me at psantos@example.com."

Salida:

{
    "Members": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
   },
   {
        "AccountId": "123456789012",
        "AdministratorId": "111122223333",
        "EmailAddress": "jstiles@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "VERIFICATION_IN_PROGRESS",
        "UpdatedTime": 1579826107000
     }
    ],
    "UnprocessedAccounts": [ ]
}

Para obtener más información, consulte Cómo invitar cuentas de miembros a un gráfico de comportamiento< https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-add-member-accounts.html > en la Guía de administración de Amazon Detective.

Invitación a cuentas de miembros sin enviar correos electrónicos de invitación

En el siguiente create-members ejemplo, se invita a dos AWS cuentas a convertirse en cuentas de miembros en el gráfico de comportamiento arn:aws:detective:us-east- 1:111122223333:graph:123412341234. Para cada cuenta, la solicitud proporciona el identificador de la cuenta y la dirección de correo electrónico del usuario raíz de la cuenta. AWS Las cuentas de los miembros no reciben correos electrónicos de invitación.

aws detective create-members \
    --accounts AccountId=444455556666,EmailAddress=mmajor@example.com AccountId=123456789012,EmailAddress=jstiles@example.com \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --disable-email-notification

Salida:

{
    "Members": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
   },
   {
        "AccountId": "123456789012",
        "AdministratorId": "111122223333",
        "EmailAddress": "jstiles@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "VERIFICATION_IN_PROGRESS",
        "UpdatedTime": 1579826107000
     }
    ],
    "UnprocessedAccounts": [ ]
}

Para obtener más información, consulte Cómo invitar cuentas de miembros a un gráfico de comportamiento< https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-add-member-accounts.html > en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte la sección CreateMembers de referencia de AWS CLI comandos.

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

AWS CLI

Deshabilitación de Detective y eliminación del gráfico de comportamiento

En el siguiente ejemplo de delete-graph, se desactiva Detective y se elimina el gráfico de comportamiento especificado.

aws detective delete-graph \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Este comando no genera ninguna salida.

Para obtener más información, consulte Disabling Amazon Detective en la Guía de administración de Amazon Detective.

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

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

AWS CLI

Eliminación de cuentas de miembro de un gráfico de comportamiento

En el siguiente ejemplo de delete-members, se eliminan dos cuentas de miembro del gráfico de comportamiento arn:aws:detective:us-east-1:111122223333:graph:123412341234. Para identificar las cuentas, la solicitud proporciona los ID de las AWS cuentas.

aws detective delete-members \
    --account-ids 444455556666 123456789012 \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Salida:

 {
    "AccountIds": [ "444455556666", "123456789012" ],
    "UnprocessedAccounts": [ ]
}

Para obtener más información, consulte Eliminar las cuentas de los miembros de un gráfico de comportamiento< https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-remove-member-accounts.html > en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte la sección DeleteMembers de referencia de AWS CLI comandos.

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

AWS CLI

Renuncia de pertenencia a un gráfico de comportamiento

El siguiente ejemplo de desasociación de pertenencia elimina la AWS cuenta que ejecuta el comando del gráfico de comportamiento arn:aws:detective:us-east- 1:111122223333:graph:123412341234.

aws detective disassociate-membership \
     --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Para obtener más información, consulte Eliminar una cuenta de un gráfico de comportamientos< > en la Guía de administración de Amazon Detective. https://docs.aws.amazon.com/detective/latest/adminguide/member-remove-self-from-graph.html

  • Para obtener más información sobre la API, consulte la sección DisassociateMembership de referencia de AWS CLI comandos.

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

AWS CLI

Recuperación de información sobre las cuentas de los miembros seleccionadas

En el siguiente ejemplo de get-members, se recupera información sobre dos cuentas de miembro del gráfico de comportamiento arn:aws:detective:us-east-1:111122223333:graph:123412341234. Para las dos cuentas, la solicitud proporciona los ID de las AWS cuentas.

aws detective get-members \
    --account-ids 444455556666 123456789012 \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Salida:

{
    "MemberDetails": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
    }
    {
        "AccountId": "123456789012",
        "AdministratorId": "111122223333",
        "EmailAddress": "jstiles@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
    }
],
    "UnprocessedAccounts": [ ]
}

Para obtener más información, consulte Visualización de la lista de cuentas en un gráfico de comportamiento< https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-view-accounts.html > en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte la sección GetMembers de referencia de AWS CLI comandos.

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

AWS CLI

Visualización de una lista de los gráficos de comportamiento que administra su cuenta

En el siguiente ejemplo de list-graphs, se recuperan los gráficos de comportamiento que administra su cuenta en la región actual.

aws detective list-graphs

Salida:

{
    "GraphList": [
        {
            "Arn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
            "CreatedTime": 1579736111000
        }
    ]
}

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

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

AWS CLI

Visualización de una lista de gráficos de comportamiento de los que una cuenta es miembro o a los que está invitada

En el siguiente ejemplo de list-invitations, se recuperan los gráficos de comportamiento a los que se ha invitado a la cuenta que realiza la llamada. Los resultados incluyen solo las invitaciones abiertas y aceptadas. No incluyen las invitaciones rechazadas ni las suscripciones eliminadas.

aws detective list-invitations

Salida:

{
    "Invitations": [
    {
        "AccountId": "444455556666",
        "AdministratorId": "111122223333",
        "EmailAddress": "mmajor@example.com",
        "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
        "InvitedTime": 1579826107000,
        "MasterId": "111122223333",
        "Status": "INVITED",
        "UpdatedTime": 1579826107000
    }
]
}

Para obtener más información, consulte Visualización de la lista de invitaciones con gráficos de comportamiento< https://docs.aws.amazon.com/detective/latest/adminguide/member-view-graph-invitations.html > en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte la sección de ListInvitations referencia de AWS CLI comandos.

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

AWS CLI

Para enumerar las cuentas de miembros de un gráfico de comportamiento

En el siguiente ejemplo de list-members, se recuperan las cuentas de los miembros invitados y habilitados para el gráfico de comportamiento de arn:aws:detective:us-east-1:111122223333:graph:123412341234. Los resultados no incluyen las cuentas de miembro eliminadas.

aws detective list-members \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Salida:

{
    "MemberDetails": [
        {
            "AccountId": "444455556666",
            "AdministratorId": "111122223333",
            "EmailAddress": "mmajor@example.com",
            "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
            "InvitedTime": 1579826107000,
            "MasterId": "111122223333",
            "Status": "INVITED",
            "UpdatedTime": 1579826107000
        },
        {
            "AccountId": "123456789012",
            "AdministratorId": "111122223333",
            "EmailAddress": "jstiles@example.com",
            "GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
            "InvitedTime": 1579826107000,
            "MasterId": "111122223333",
            "PercentOfGraphUtilization": 2,
            "PercentOfGraphUtilizationUpdatedTime": 1586287843,
            "Status": "ENABLED",
            "UpdatedTime": 1579973711000,
            "VolumeUsageInBytes": 200,
            "VolumeUsageUpdatedTime": 1586287843
        }
    ]
}

Para obtener más información, consulte Viewing the list of accounts in a behavior graph en la Guía de administración de Amazon Detective.

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

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

AWS CLI

Recuperación de las etiquetas asignadas a un gráfico de comportamiento

En el ejemplo siguiente de list-tags-for-resource, se devuelven las etiquetas asignadas al gráfico de comportamiento especificado.

aws detective list-tags-for-resource \
    --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Salida:

{
    "Tags": {
        "Department" : "Finance"
    }
}

Para obtener más información, consulte Managing tags for a behavior graph en la Guía de administración de Amazon Detective.

En el siguiente ejemplo de código, se muestra cómo utilizar reject-invitation.

AWS CLI

Rechazo de una invitación para ser una cuenta miembro de un gráfico de comportamiento

En el siguiente ejemplo de reject-invitation, se rechaza una invitación para convertirse en una cuenta miembro de un gráfico de comportamiento arn:aws:detective:us-east- 1:111122223333:graph:123412341234.

aws detective reject-invitation \
    --graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234

Este comando no genera ninguna salida.

Para obtener más información, consulte Responder a una invitación en un gráfico de comportamiento< https://docs.aws.amazon.com/detective/latest/adminguide/member-invitation-response.html > en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte la sección de RejectInvitation referencia de AWS CLI comandos.

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

AWS CLI

Asignación de una etiqueta a un recurso

En el siguiente ejemplo de tag-resource, se asigna un valor para la etiqueta Department al gráfico de comportamiento especificado.

aws detective tag-resource \
    --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --tags '{"Department":"Finance"}'

Este comando no genera ninguna salida.

Para obtener más información, consulte Managing tags for a behavior graph en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte TagResource AWS CLI Command Reference.

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

AWS CLI

Eliminación de un valor de etiqueta de un recurso

En el siguiente ejemplo de untag-resource, se elimina la etiqueta Department del gráfico de comportamiento especificado.

aws detective untag-resource \
    --resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
    --tag-keys "Department"

Este comando no genera ninguna salida.

Para obtener más información, consulte Managing tags for a behavior graph en la Guía de administración de Amazon Detective.

  • Para obtener más información sobre la API, consulte UntagResource AWS CLI Command Reference.