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. # Úselo `DescribeAddresses` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `DescribeAddresses`. ------ #### [ C\$1\$1 ] **SDK para C\$1\$1** Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/ec2#code-examples). ``` //! Describe all Elastic IP addresses. /*! \param clientConfiguration: AWS client configuration. \return bool: Function succeeded. */ bool AwsDoc::EC2::describeAddresses( const Aws::Client::ClientConfiguration &clientConfiguration) { Aws::EC2::EC2Client ec2Client(clientConfiguration); Aws::EC2::Model::DescribeAddressesRequest request; Aws::EC2::Model::DescribeAddressesOutcome outcome = ec2Client.DescribeAddresses(request); if (outcome.IsSuccess()) { std::cout << std::left << std::setw(20) << "InstanceId" << std::setw(15) << "Public IP" << std::setw(10) << "Domain" << std::setw(30) << "Allocation ID" << std::setw(25) << "NIC ID" << std::endl; const Aws::Vector &addresses = outcome.GetResult().GetAddresses(); for (const auto &address: addresses) { Aws::String domainString = Aws::EC2::Model::DomainTypeMapper::GetNameForDomainType( address.GetDomain()); std::cout << std::left << std::setw(20) << address.GetInstanceId() << std::setw(15) << address.GetPublicIp() << std::setw(10) << domainString << std::setw(30) << address.GetAllocationId() << std::setw(25) << address.GetNetworkInterfaceId() << std::endl; } } else { std::cerr << "Failed to describe Elastic IP addresses:" << outcome.GetError().GetMessage() << std::endl; } return outcome.IsSuccess(); } ``` + Para obtener más información sobre la API, consulta [DescribeAddresses](https://docs.aws.amazon.com/goto/SdkForCpp/ec2-2016-11-15/DescribeAddresses)la *Referencia AWS SDK para C\$1\$1 de la API*. ------ #### [ CLI ] **AWS CLI** **Ejemplo 1: Recuperar detalles sobre todas las direcciones IP elásticas** En el siguiente ejemplo de `describe addresses`, se muestran los detalles de las direcciones IP elásticas. ``` aws ec2 describe-addresses ``` Salida: ``` { "Addresses": [ { "InstanceId": "i-1234567890abcdef0", "PublicIp": "198.51.100.0", "PublicIpv4Pool": "amazon", "Domain": "standard" }, { "Domain": "vpc", "PublicIpv4Pool": "amazon", "InstanceId": "i-1234567890abcdef0", "NetworkInterfaceId": "eni-12345678", "AssociationId": "eipassoc-12345678", "NetworkInterfaceOwnerId": "123456789012", "PublicIp": "203.0.113.0", "AllocationId": "eipalloc-12345678", "PrivateIpAddress": "10.0.1.241" } ] } ``` **Ejemplo 2: Recuperar detalles sobre las direcciones IP elásticas de EC2-VPC** En el siguiente ejemplo de `describe-addresses`, se muestran detalles sobre las direcciones IP elásticas para usarlas con las instancias de una VPC. ``` aws ec2 describe-addresses \ --filters "Name=domain,Values=vpc" ``` Salida: ``` { "Addresses": [ { "Domain": "vpc", "PublicIpv4Pool": "amazon", "InstanceId": "i-1234567890abcdef0", "NetworkInterfaceId": "eni-12345678", "AssociationId": "eipassoc-12345678", "NetworkInterfaceOwnerId": "123456789012", "PublicIp": "203.0.113.0", "AllocationId": "eipalloc-12345678", "PrivateIpAddress": "10.0.1.241" } ] } ``` **Ejemplo 3: recuperar detalles sobre una dirección IP elástica especificada por el ID de asignación** En el siguiente ejemplo de `describe-addresses`, se muestran los detalles sobre la dirección IP elástica con el ID de asignación especificado, el cual está asociado a una instancia en EC2-VPC. ``` aws ec2 describe-addresses \ --allocation-ids eipalloc-282d9641 ``` Salida: ``` { "Addresses": [ { "Domain": "vpc", "PublicIpv4Pool": "amazon", "InstanceId": "i-1234567890abcdef0", "NetworkInterfaceId": "eni-1a2b3c4d", "AssociationId": "eipassoc-123abc12", "NetworkInterfaceOwnerId": "1234567891012", "PublicIp": "203.0.113.25", "AllocationId": "eipalloc-282d9641", "PrivateIpAddress": "10.251.50.12" } ] } ``` **Ejemplo 4: recuperar detalles sobre una dirección IP elástica especificada por la dirección IP privada de su VPC** En el siguiente ejemplo de `describe-addresses`, se muestran los detalles sobre la dirección IP elástica asociada a una dirección IP privada en particular en EC2-VPC. ``` aws ec2 describe-addresses \ --filters "Name=private-ip-address,Values=10.251.50.12" ``` **Ejemplo 5: recuperar detalles sobre las direcciones IP elásticas en EC2-Classic** En el siguiente `describe-addresses` ejemplo, se muestran detalles sobre las direcciones IP elásticas para su uso en EC2-Classic. ``` aws ec2 describe-addresses \ --filters "Name=domain,Values=standard" ``` Salida: ``` { "Addresses": [ { "InstanceId": "i-1234567890abcdef0", "PublicIp": "203.0.110.25", "PublicIpv4Pool": "amazon", "Domain": "standard" } ] } ``` **Ejemplo 6: recuperar detalles sobre una dirección IP elástica especificada por la dirección IP pública** En el siguiente ejemplo de `describe-addresses`, se muestran detalles sobre la dirección IP elástica con el valor `203.0.110.25`, el cual está asociado a una instancia en EC2-Classic. ``` aws ec2 describe-addresses \ --public-ips 203.0.110.25 ``` Salida: ``` { "Addresses": [ { "InstanceId": "i-1234567890abcdef0", "PublicIp": "203.0.110.25", "PublicIpv4Pool": "amazon", "Domain": "standard" } ] } ``` + Para obtener más información sobre la API, consulte la Referencia [DescribeAddresses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-addresses.html)de *AWS CLI comandos*. ------ #### [ JavaScript ] **SDK para JavaScript (v3)** Hay más información. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/ec2#code-examples). ``` import { DescribeAddressesCommand, EC2Client } from "@aws-sdk/client-ec2"; /** * Describes the specified Elastic IP addresses or all of your Elastic IP addresses. * @param {{ allocationId: string }} options */ export const main = async ({ allocationId }) => { const client = new EC2Client({}); const command = new DescribeAddressesCommand({ // You can omit this property to show all addresses. AllocationIds: [allocationId], }); try { const { Addresses } = await client.send(command); const addressList = Addresses.map((address) => ` • ${address.PublicIp}`); console.log("Elastic IP addresses:"); console.log(addressList.join("\n")); } catch (caught) { if ( caught instanceof Error && caught.name === "InvalidAllocationID.NotFound" ) { console.warn(`${caught.message}. Please provide a valid AllocationId.`); } else { throw caught; } } }; ``` + Para obtener más información sobre la API, consulta [DescribeAddresses](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ec2/command/DescribeAddressesCommand)la *Referencia AWS SDK para JavaScript de la API*. ------ #### [ PowerShell ] **Herramientas para la PowerShell versión 4** **Ejemplo 1: En este ejemplo se describe la dirección IP elástica especificada para las instancias de EC2-Classic.** ``` Get-EC2Address -AllocationId eipalloc-12345678 ``` **Salida:** ``` AllocationId : eipalloc-12345678 AssociationId : eipassoc-12345678 Domain : vpc InstanceId : i-87654321 NetworkInterfaceId : eni-12345678 NetworkInterfaceOwnerId : 12345678 PrivateIpAddress : 10.0.2.172 PublicIp : 198.51.100.2 ``` **Ejemplo 2: En este ejemplo se describen las direcciones IP elásticas para las instancias de una VPC. Esta sintaxis requiere PowerShell la versión 3 o posterior.** ``` Get-EC2Address -Filter @{ Name="domain";Values="vpc" } ``` **Ejemplo 3: En este ejemplo se describe la dirección IP elástica especificada para las instancias de EC2-Classic.** ``` Get-EC2Address -PublicIp 203.0.113.17 ``` **Salida:** ``` AllocationId : AssociationId : Domain : standard InstanceId : i-12345678 NetworkInterfaceId : NetworkInterfaceOwnerId : PrivateIpAddress : PublicIp : 203.0.113.17 ``` **Ejemplo 4: En este ejemplo se describen las direcciones IP elásticas para las instancias de EC2-Classic. Esta sintaxis requiere PowerShell la versión 3 o posterior.** ``` Get-EC2Address -Filter @{ Name="domain";Values="standard" } ``` **Ejemplo 5: En este ejemplo se describen todas las direcciones IP elásticas.** ``` Get-EC2Address ``` **Ejemplo 6: En este ejemplo se devuelve la IP pública y privada del identificador de instancia proporcionado en el filtro.** ``` Get-EC2Address -Region eu-west-1 -Filter @{Name="instance-id";Values="i-0c12d3f4f567ffb89"} | Select-Object PrivateIpAddress, PublicIp ``` **Salida:** ``` PrivateIpAddress PublicIp ---------------- -------- 10.0.0.99 63.36.5.227 ``` **Ejemplo 7: Este ejemplo recupera todo el Elastic IPs con su identificador de asignación, identificador de asociación e identificador de instancia** ``` Get-EC2Address -Region eu-west-1 | Select-Object InstanceId, AssociationId, AllocationId, PublicIp ``` **Salida:** ``` InstanceId AssociationId AllocationId PublicIp ---------- ------------- ------------ -------- eipalloc-012e3b456789e1fad 17.212.120.178 i-0c123dfd3415bac67 eipassoc-0e123456bb7890bdb eipalloc-01cd23ebf45f7890c 17.212.124.77 eipalloc-012345678eeabcfad 17.212.225.7 i-0123d405c67e89a0c eipassoc-0c123b456783966ba eipalloc-0123cdd456a8f7892 37.216.52.173 i-0f1bf2f34c5678d09 eipassoc-0e12934568a952d96 eipalloc-0e1c23e4d5e6789e4 37.218.222.278 i-012e3cb4df567e8aa eipassoc-0d1b2fa4d67d03810 eipalloc-0123f456f78a01b58 37.210.82.27 i-0123bcf4b567890e1 eipassoc-01d2345f678903fb1 eipalloc-0e1db23cfef5c45c7 37.215.222.270 ``` **Ejemplo 8: En este ejemplo se obtiene la lista de direcciones IP de EC2 que coinciden con la clave de etiqueta “Category” con el valor “Prod”.** ``` Get-EC2Address -Filter @{Name="tag:Category";Values="Prod"} ``` **Salida:** ``` AllocationId : eipalloc-0123f456f81a01b58 AssociationId : eipassoc-0d1b23a456d103810 CustomerOwnedIp : CustomerOwnedIpv4Pool : Domain : vpc InstanceId : i-012e3cb4df567e1aa NetworkBorderGroup : eu-west-1 NetworkInterfaceId : eni-0123f41d5a60d5f40 NetworkInterfaceOwnerId : 123456789012 PrivateIpAddress : 192.168.1.84 PublicIp : 34.250.81.29 PublicIpv4Pool : amazon Tags : {Category, Name} ``` + Para obtener más información sobre la API, consulte [DescribeAddresses Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (*V4). **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se describe la dirección IP elástica especificada para las instancias de EC2-Classic.** ``` Get-EC2Address -AllocationId eipalloc-12345678 ``` **Salida:** ``` AllocationId : eipalloc-12345678 AssociationId : eipassoc-12345678 Domain : vpc InstanceId : i-87654321 NetworkInterfaceId : eni-12345678 NetworkInterfaceOwnerId : 12345678 PrivateIpAddress : 10.0.2.172 PublicIp : 198.51.100.2 ``` **Ejemplo 2: En este ejemplo se describen las direcciones IP elásticas para las instancias de una VPC. Esta sintaxis requiere la PowerShell versión 3 o posterior.** ``` Get-EC2Address -Filter @{ Name="domain";Values="vpc" } ``` **Ejemplo 3: En este ejemplo se describe la dirección IP elástica especificada para las instancias de EC2-Classic.** ``` Get-EC2Address -PublicIp 203.0.113.17 ``` **Salida:** ``` AllocationId : AssociationId : Domain : standard InstanceId : i-12345678 NetworkInterfaceId : NetworkInterfaceOwnerId : PrivateIpAddress : PublicIp : 203.0.113.17 ``` **Ejemplo 4: En este ejemplo se describen las direcciones IP elásticas para las instancias de EC2-Classic. Esta sintaxis requiere PowerShell la versión 3 o posterior.** ``` Get-EC2Address -Filter @{ Name="domain";Values="standard" } ``` **Ejemplo 5: En este ejemplo se describen todas las direcciones IP elásticas.** ``` Get-EC2Address ``` **Ejemplo 6: En este ejemplo se devuelve la IP pública y privada del identificador de instancia proporcionado en el filtro.** ``` Get-EC2Address -Region eu-west-1 -Filter @{Name="instance-id";Values="i-0c12d3f4f567ffb89"} | Select-Object PrivateIpAddress, PublicIp ``` **Salida:** ``` PrivateIpAddress PublicIp ---------------- -------- 10.0.0.99 63.36.5.227 ``` **Ejemplo 7: Este ejemplo recupera todo el Elastic IPs con su identificador de asignación, identificador de asociación e identificador de instancia** ``` Get-EC2Address -Region eu-west-1 | Select-Object InstanceId, AssociationId, AllocationId, PublicIp ``` **Salida:** ``` InstanceId AssociationId AllocationId PublicIp ---------- ------------- ------------ -------- eipalloc-012e3b456789e1fad 17.212.120.178 i-0c123dfd3415bac67 eipassoc-0e123456bb7890bdb eipalloc-01cd23ebf45f7890c 17.212.124.77 eipalloc-012345678eeabcfad 17.212.225.7 i-0123d405c67e89a0c eipassoc-0c123b456783966ba eipalloc-0123cdd456a8f7892 37.216.52.173 i-0f1bf2f34c5678d09 eipassoc-0e12934568a952d96 eipalloc-0e1c23e4d5e6789e4 37.218.222.278 i-012e3cb4df567e8aa eipassoc-0d1b2fa4d67d03810 eipalloc-0123f456f78a01b58 37.210.82.27 i-0123bcf4b567890e1 eipassoc-01d2345f678903fb1 eipalloc-0e1db23cfef5c45c7 37.215.222.270 ``` **Ejemplo 8: En este ejemplo se obtiene la lista de direcciones IP de EC2 que coinciden con la clave de etiqueta “Category” con el valor “Prod”.** ``` Get-EC2Address -Filter @{Name="tag:Category";Values="Prod"} ``` **Salida:** ``` AllocationId : eipalloc-0123f456f81a01b58 AssociationId : eipassoc-0d1b23a456d103810 CustomerOwnedIp : CustomerOwnedIpv4Pool : Domain : vpc InstanceId : i-012e3cb4df567e1aa NetworkBorderGroup : eu-west-1 NetworkInterfaceId : eni-0123f41d5a60d5f40 NetworkInterfaceOwnerId : 123456789012 PrivateIpAddress : 192.168.1.84 PublicIp : 34.250.81.29 PublicIpv4Pool : amazon Tags : {Category, Name} ``` + Para obtener más información sobre la API, consulte [DescribeAddresses Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ec2#code-examples). ``` TRY. oo_result = lo_ec2->describeaddresses( ). " oo_result is returned for testing purposes. " DATA(lt_addresses) = oo_result->get_addresses( ). MESSAGE 'Retrieved information about Elastic IP addresses.' TYPE 'I'. CATCH /aws1/cx_rt_service_generic INTO DATA(lo_exception). DATA(lv_error) = |"{ lo_exception->av_err_code }" - { lo_exception->av_err_msg }|. MESSAGE lv_error TYPE 'E'. ENDTRY. ``` + Para obtener más información sobre la API, consulte [DescribeAddresses](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ Para obtener una lista completa de guías para desarrolladores del AWS SDK y ejemplos de código, consulte[Creación de recursos de Amazon EC2 mediante una AWS SDK](sdk-general-information-section.md). En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.