Ejemplos de Network Manager que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

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 Network Manager que utilizan AWS CLI

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

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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

El siguiente ejemplo de código muestra cómo usarloassociate-customer-gateway.

AWS CLI

Para asociar una pasarela de clientes

El siguiente associate-customer-gateway ejemplo asocia la pasarela de cliente cgw-11223344556677889 de la red global especificada con el dispositivodevice-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

Salida:

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

Para obtener más información, consulte Customer Gateway Associations en la Guía del administrador de redes de Transit Gateway.

En el siguiente ejemplo de código se muestra cómo usarloassociate-link.

AWS CLI

Para asociar un enlace

El siguiente associate-link ejemplo asocia el enlace link-11112222aaaabbbb1 con el dispositivodevice-07f6fd08867abc123. El enlace y el dispositivo se encuentran en la red global especificada.

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

Salida:

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

Para obtener más información, consulte Asociaciones de dispositivos y enlaces en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarlocreate-core-network.

AWS CLI

Para crear una red principal

En el siguiente create-core-network ejemplo, se crea una red principal con una descripción y etiquetas opcionales dentro de una red WAN global de AWS nube.

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

Salida:

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

Para obtener más información, consulte Redes globales y principales en la Guía del WAN usuario de la AWS nube.

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

En el siguiente ejemplo de código se muestra cómo usarlocreate-device.

AWS CLI

Para crear un dispositivo

En el siguiente create-device ejemplo, se crea un dispositivo en la red global especificada. Los detalles del dispositivo incluyen una descripción, el tipo, el proveedor, el modelo y el número de serie.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con dispositivos en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarlocreate-global-network.

AWS CLI

Para crear una red global

Los siguientes create-global-network ejemplos crean una nueva red global. El estado inicial tras la creación esPENDING.

aws networkmanager create-global-network

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarlocreate-link.

AWS CLI

Para crear un enlace

En el siguiente create-link ejemplo, se crea un enlace en la red global especificada. El enlace incluye una descripción y detalles sobre el tipo de enlace, el ancho de banda y el proveedor. El ID del sitio indica el sitio al que está asociado el enlace.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con enlaces en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarlocreate-site.

AWS CLI

Para crear un sitio

En el siguiente create-site ejemplo, se crea un sitio en la red global especificada. Los detalles del sitio incluyen una descripción y la información de ubicación.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con sitios en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarlocreate-vpc-attachment.

AWS CLI

Para crear un VPC archivo adjunto

En el siguiente create-vpc-attachment ejemplo, se crea un VPC adjunto con IPv6 soporte en una red principal.

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

Salida:

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

Para obtener más información, consulte Crear un archivo adjunto en la Guía del WAN usuario de Cloud.

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

En el siguiente ejemplo de código se muestra cómo usarlodelete-attachment.

AWS CLI

Para eliminar un archivo adjunto

En el siguiente delete-attachment ejemplo, se elimina un adjunto de Connect.

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

Salida:

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

Para obtener más información, consulte Eliminar archivos adjuntos en la Guía del WAN usuario de Cloud.

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

En el siguiente ejemplo de código se muestra cómo usarlodelete-bucket-analytics-configuration.

AWS CLI

Eliminar una configuración de análisis de un bucket

En el siguiente ejemplo de delete-bucket-analytics-configuration, se elimina la configuración de análisis para el bucket e ID especificados.

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

Este comando no genera ninguna salida.

En el siguiente ejemplo de código se muestra cómo usarlodelete-bucket-metrics-configuration.

AWS CLI

Eliminar una configuración de métricas de un bucket

En el siguiente ejemplo de delete-bucket-metrics-configuration, se elimina la configuración de métricas para el bucket e ID especificados.

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

Este comando no genera ninguna salida.

En el siguiente ejemplo de código se muestra cómo usarlodelete-core-network.

AWS CLI

Para eliminar una red principal

En el siguiente delete-core-network ejemplo, se elimina una red principal de una red WAN global en la nube.

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

Salida:

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

Para obtener más información, consulte la Guía del WAN usuario sobre las redes principales en la nube.

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

En el siguiente ejemplo de código se muestra cómo usarlodelete-device.

AWS CLI

Para eliminar un dispositivo

En el siguiente delete-device ejemplo, se elimina el dispositivo especificado de la red global especificada.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con dispositivos en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarlodelete-global-network.

AWS CLI

Para eliminar una red global

En el siguiente delete-global-network ejemplo, se elimina una red global.

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarlodelete-link.

AWS CLI

Para eliminar un enlace

En el siguiente delete-link ejemplo, se elimina el enlace especificado de la red global especificada.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con enlaces en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarlodelete-public-access-block.

AWS CLI

Eliminar la configuración de bloqueo de acceso público de un bucket

En el siguiente ejemplo de delete-public-access-block, se elimina la configuración de bloqueo de acceso público en el bucket especificado.

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

Este comando no genera ninguna salida.

En el siguiente ejemplo de código se muestra cómo usarlodelete-site.

AWS CLI

Para eliminar un sitio

En el siguiente delete-site ejemplo, se elimina el sitio especificado (site-444555aaabbb11223) de la red global especificada.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con sitios en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarloderegister-transit-gateway.

AWS CLI

Para anular el registro de una puerta de enlace de tránsito de una red global

El siguiente deregister-transit-gateway ejemplo anula el registro de la puerta de enlace de tránsito especificada de la red global especificada.

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

Salida:

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

Para obtener más información, consulte Registros de Transit Gateway en la Guía del administrador de redes de Transit Gateway.

En el siguiente ejemplo de código se muestra cómo usarlodescribe-global-networks.

AWS CLI

Para describir sus redes globales

En el siguiente describe-global-networks ejemplo, se describen todas las redes globales de su cuenta.

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usarlodisassociate-customer-gateway.

AWS CLI

Para desasociar una pasarela de clientes

El siguiente disassociate-customer-gateway ejemplo desasocia la pasarela de clientes especificada (cgw-11223344556677889) de la red global especificada.

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

Salida:

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

Para obtener más información, consulte Customer Gateway Associations en la Guía del administrador de redes de Transit Gateway.

En el siguiente ejemplo de código se muestra cómo usarlodisassociate-link.

AWS CLI

Para desasociar un enlace

El siguiente disassociate-link ejemplo desasocia el enlace especificado del dispositivo de device-07f6fd08867abc123 la red global especificada.

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

Salida:

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

Para obtener más información, consulte Asociaciones de dispositivos y enlaces en la Guía del administrador de red de Transit Gateway.

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

En el siguiente ejemplo de código se muestra cómo usarloget-bucket-analytics-configuration.

AWS CLI

Recuperar la configuración de análisis de un bucket con un ID específico

En el siguiente ejemplo de get-bucket-analytics-configuration, se muestra la configuración de análisis para el bucket e ID especificados.

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usarloget-bucket-metrics-configuration.

AWS CLI

Recuperar la configuración de métricas de un bucket con un ID específico

En el siguiente ejemplo de get-bucket-metrics-configuration, se muestra la configuración de métricas para el bucket e ID especificados.

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usarloget-customer-gateway-associations.

AWS CLI

Para obtener sus asociaciones de pasarelas de clientes

En el siguiente get-customer-gateway-associations ejemplo, se obtienen las asociaciones de pasarelas de clientes de la red global especificada.

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usarloget-devices.

AWS CLI

Para obtener tus dispositivos

En el siguiente get-devices ejemplo, se obtienen los dispositivos de la red global especificada.

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarloget-link-associations.

AWS CLI

Para obtener sus asociaciones de enlaces

En el siguiente get-link-associations ejemplo, se obtienen las asociaciones de enlaces de la red global especificada.

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarloget-links.

AWS CLI

Para obtener tus enlaces

El siguiente get-links ejemplo obtiene los enlaces de la red global especificada.

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarloget-object-retention.

AWS CLI

Para recuperar la configuración de retención de un objeto

En el siguiente ejemplo de get-object-retention, se recupera la configuración de retención del objeto especificado.

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarloget-public-access-block.

AWS CLI

Establecer o modificar la configuración de bloqueo de acceso público de un bucket

En el siguiente ejemplo de get-public-access-block, se elimina la configuración de bloqueo de acceso público del bucket especificado.

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarloget-sites.

AWS CLI

Para obtener sus sitios

En el siguiente get-sites ejemplo, se obtienen los sitios de la red global especificada.

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarloget-transit-gateway-registrations.

AWS CLI

Para obtener tus registros en Transit Gateway

En el siguiente get-transit-gateway-registrations ejemplo, se obtienen las pasarelas de tránsito que están registradas en la red global especificada.

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usarloget-vpc-attachment.

AWS CLI

Para obtener un VPC archivo adjunto

El siguiente get-vpc-attachment ejemplo devuelve información sobre un VPC archivo adjunto.

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

Salida:

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

Para obtener más información, consulte la Guía del WAN usuario de Adjuntos en la nube.

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

En el siguiente ejemplo de código se muestra cómo usarlolist-bucket-analytics-configurations.

AWS CLI

Recuperar una lista de configuraciones de análisis para un bucket

El siguiente list-bucket-analytics-configurations recupera una lista de configuraciones de análisis para el bucket especificado.

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

Salida:

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

En el siguiente ejemplo de código se muestra cómo usarlolist-bucket-metrics-configurations.

AWS CLI

Para recuperar una lista de configuraciones de métricas para un bucket

En el siguiente list-bucket-metrics-configurations ejemplo, se recupera una lista de configuraciones de métricas para el depósito especificado.

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

Salida:

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

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

AWS CLI

Para enumerar las etiquetas de un recurso

En el siguiente list-tags-for-resource ejemplo, se enumeran las etiquetas del recurso de dispositivo especificado (device-07f6fd08867abc123).

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

Salida:

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

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

En el siguiente ejemplo de código se muestra cómo usarloput-bucket-metrics-configuration.

AWS CLI

Para establecer una configuración de métricas para un bucket

En el siguiente put-bucket-metrics-configuration ejemplo, se establece una configuración métrica con el ID 123 para el depósito especificado.

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

Este comando no genera ninguna salida.

El siguiente ejemplo de código muestra cómo usarloput-object-retention.

AWS CLI

Para establecer la configuración de retención de un objeto

En el siguiente ejemplo de put-object-retention, se establece una configuración de retención del objeto especificado hasta el 1 de enero de 2025.

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

Este comando no genera ninguna salida.

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

El siguiente ejemplo de código muestra cómo usarloput-public-access-block.

AWS CLI

Para establecer la configuración de acceso público en bloque para un bucket

En el siguiente put-public-access-block ejemplo, se establece una configuración restrictiva de acceso público en bloque para el depósito especificado.

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

Este comando no genera ninguna salida.

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

El siguiente ejemplo de código muestra cómo usarloregister-transit-gateway.

AWS CLI

Para registrar una pasarela de tránsito en una red global

El siguiente register-transit-gateway ejemplo registra la puerta de enlace de tránsito tgw-123abc05e04123abc en la red global especificada.

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

Salida:

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

Para obtener más información, consulte Registros de Transit Gateway en la Guía del administrador de redes de Transit Gateway.

El siguiente ejemplo de código muestra cómo usarloreject-attachment.

AWS CLI

Para rechazar un archivo adjunto

En el siguiente reject-attachment ejemplo, se rechaza una solicitud de VPC adjunto.

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

Salida:

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

Para obtener más información, consulte Aceptación de archivos adjuntos en la Guía del WAN usuario de Cloud.

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

El siguiente ejemplo de código muestra cómo usarlostart-route-analysis.

AWS CLI

Para iniciar el análisis de rutas

El siguiente start-route-analysis ejemplo inicia el análisis entre un origen y un destino, incluido el opcionalinclude-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

Salida:

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

Para obtener más información, consulte Route Analyzer en la Guía del usuario de AWS Global Networks for Transit Gateways.

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

El siguiente ejemplo de código muestra cómo usarlotag-resource.

AWS CLI

Para aplicar etiquetas a un recurso

En el siguiente tag-resource ejemplo, se aplica la etiqueta Network=Northeast al dispositivodevice-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

Este comando no genera ninguna salida.

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

El siguiente ejemplo de código muestra cómo usarlountag-resource.

AWS CLI

Cómo eliminar etiquetas de un recurso

En el siguiente untag-resource ejemplo, se elimina la etiqueta con la clave Network del dispositivodevice-07f6fd08867abc123.

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

Este comando no genera ninguna salida.

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

El siguiente ejemplo de código muestra cómo usarloupdate-device.

AWS CLI

Para actualizar un dispositivo

En el siguiente update-device ejemplo, se actualiza device-07f6fd08867abc123 el dispositivo especificando un ID de sitio para el dispositivo.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con dispositivos en la Guía del administrador de red de Transit Gateway.

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

El siguiente ejemplo de código muestra cómo usarloupdate-global-network.

AWS CLI

Para actualizar una red global

En el siguiente update-global-network ejemplo, se actualiza la descripción de la red globalglobal-network-01231231231231231.

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

Salida:

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

Para obtener más información, consulte Redes globales en la Guía del administrador de redes de Transit Gateway.

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

El siguiente ejemplo de código muestra cómo usarloupdate-link.

AWS CLI

Para actualizar un enlace

El siguiente update-link ejemplo actualiza la información de ancho de banda del enlacelink-11112222aaaabbbb1.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con enlaces en la Guía del administrador de red de Transit Gateway.

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

El siguiente ejemplo de código muestra cómo usarloupdate-site.

AWS CLI

Para actualizar un sitio

En el siguiente update-site ejemplo, se actualiza la descripción del sitio site-444555aaabbb11223 de la red global especificada.

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

Salida:

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

Para obtener más información, consulte Cómo trabajar con sitios en la Guía del administrador de red de Transit Gateway.

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