Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden Sie `DescribeVpcs`mit einemAWSSDK oder CLI
Die folgenden Code-Beispiele zeigen, wie `DescribeVpcs` verwendet wird.
Aktionsbeispiele sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Sie können diese Aktion in den folgenden Codebeispielen im Kontext sehen:
+ [Erstellen und Verwalten eines ausfallsicheren Services](example_cross_ResilientService_section.md)
+ [Konfigurieren Sie die Konnektivität des Containerdienstes](example_ecs_ServiceConnect_085_section.md)
+ [Erstellen Sie ein grundlegendes virtuelles privates Netzwerk](example_vpc_GettingStartedCLI_section.md)
+ [Erstellen Sie eine Container-Aufgabe für den serverlosen Starttyp](example_ecs_GettingStarted_086_section.md)
+ [Einen Containerdienst für VM-Instanzen erstellen](example_ecs_GettingStarted_018_section.md)
+ [Eine relationale Datenbankinstanz erstellen](example_rds_GettingStarted_036_section.md)
+ [Ein Service Networking Mesh erstellen und verwalten](example_vpc_lattice_GettingStarted_055_section.md)
+ [Blockspeicher-Volumes erstellen und verwalten](example_ec2_GettingStarted_020_section.md)
+ [Erste Schritte mit Dokumentendatenbanken](example_docdb_GettingStarted_025_section.md)
+ [Erste Schritte mit dem Lastenausgleich](example_elastic_load_balancing_v2_GettingStarted_058_section.md)
+ [Erste Schritte mit verwaltetem Streaming](example_ec2_GettingStarted_057_section.md)
+ [Erste Schritte mit Network Transit Gateways](example_vpc_TransitGatewayGettingStarted_section.md)
+ [Virtuelles privates Netzwerk mit IP-Adressverwaltung](example_vpc_GettingStartedIpam_section.md)
+ [Arbeiten mit Netzwerk-Peering-Verbindungen](example_ec2_GettingStarted_015_section.md)
------
#### [ .NET ]
**SDK für .NET**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS-Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/cross-service/ResilientService/AutoScalerActions#code-examples) einrichten und ausführen.
```
///
/// Get the default VPC for the account.
///
/// The default VPC object.
public async Task GetDefaultVpc()
{
try
{
var vpcResponse = await _amazonEc2.DescribeVpcsAsync(
new DescribeVpcsRequest()
{
Filters = new List()
{
new("is-default", new List() { "true" })
}
});
return vpcResponse.Vpcs[0];
}
catch (AmazonEC2Exception ec2Exception)
{
if (ec2Exception.ErrorCode == "UnauthorizedOperation")
{
_logger.LogError(ec2Exception, $"You do not have the necessary permissions to describe VPCs.");
}
throw;
}
catch (Exception ex)
{
_logger.LogError(ex, $"An error occurred while describing the vpcs.: {ex.Message}");
throw;
}
}
```
+ Einzelheiten zur API finden Sie [DescribeVpcs](https://docs.aws.amazon.com/goto/DotNetSDKV3/ec2-2016-11-15/DescribeVpcs)in der *AWS SDK für .NETAPI-Referenz*.
------
#### [ CLI ]
**AWS CLI**
**Beispiel 1: So beschreiben Sie alle Ihre VPCs**
Im folgenden Beispiel für `describe-vpcs` werden Details über Ihre VPCs abgerufen.
```
aws ec2 describe-vpcs
```
Ausgabe:
```
{
"Vpcs": [
{
"CidrBlock": "30.1.0.0/16",
"DhcpOptionsId": "dopt-19edf471",
"State": "available",
"VpcId": "vpc-0e9801d129EXAMPLE",
"OwnerId": "111122223333",
"InstanceTenancy": "default",
"CidrBlockAssociationSet": [
{
"AssociationId": "vpc-cidr-assoc-062c64cfafEXAMPLE",
"CidrBlock": "30.1.0.0/16",
"CidrBlockState": {
"State": "associated"
}
}
],
"IsDefault": false,
"Tags": [
{
"Key": "Name",
"Value": "Not Shared"
}
]
},
{
"CidrBlock": "10.0.0.0/16",
"DhcpOptionsId": "dopt-19edf471",
"State": "available",
"VpcId": "vpc-06e4ab6c6cEXAMPLE",
"OwnerId": "222222222222",
"InstanceTenancy": "default",
"CidrBlockAssociationSet": [
{
"AssociationId": "vpc-cidr-assoc-00b17b4eddEXAMPLE",
"CidrBlock": "10.0.0.0/16",
"CidrBlockState": {
"State": "associated"
}
}
],
"IsDefault": false,
"Tags": [
{
"Key": "Name",
"Value": "Shared VPC"
}
]
}
]
}
```
**Beispiel 2: So beschreiben Sie eine bestimmte VPC**
Im folgenden Beispiel für `describe-vpcs` werden Details für die angegebene VPC abgerufen.
```
aws ec2 describe-vpcs \
--vpc-ids {{vpc-06e4ab6c6cEXAMPLE}}
```
Ausgabe:
```
{
"Vpcs": [
{
"CidrBlock": "10.0.0.0/16",
"DhcpOptionsId": "dopt-19edf471",
"State": "available",
"VpcId": "vpc-06e4ab6c6cEXAMPLE",
"OwnerId": "111122223333",
"InstanceTenancy": "default",
"CidrBlockAssociationSet": [
{
"AssociationId": "vpc-cidr-assoc-00b17b4eddEXAMPLE",
"CidrBlock": "10.0.0.0/16",
"CidrBlockState": {
"State": "associated"
}
}
],
"IsDefault": false,
"Tags": [
{
"Key": "Name",
"Value": "Shared VPC"
}
]
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeVpcs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-vpcs.html)in der *AWS CLIBefehlsreferenz*.
------
#### [ JavaScript ]
**SDK für JavaScript (v3)**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS-Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cross-services/wkflw-resilient-service#code-examples) einrichten und ausführen.
```
const client = new EC2Client({});
const { Vpcs } = await client.send(
new DescribeVpcsCommand({
Filters: [{ Name: "is-default", Values: ["true"] }],
}),
);
```
+ Einzelheiten zur API finden Sie [DescribeVpcs](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ec2/command/DescribeVpcsCommand)in der *AWS SDK für JavaScriptAPI-Referenz*.
------
#### [ PowerShell ]
**Tools für PowerShell V4**
**Beispiel 1: In diesem Beispiel wird die angegebene VPC beschrieben.**
```
Get-EC2Vpc -VpcId vpc-12345678
```
**Ausgabe:**
```
CidrBlock : 10.0.0.0/16
DhcpOptionsId : dopt-1a2b3c4d
InstanceTenancy : default
IsDefault : False
State : available
Tags : {Name}
VpcId : vpc-12345678
```
**Beispiel 2: In diesem Beispiel wird die Standard-VPC beschrieben (es kann nur eine pro Region geben). Wenn Ihr Konto EC2-Classic in dieser Region unterstützt, gibt es keine Standard-VPC.**
```
Get-EC2Vpc -Filter @{Name="isDefault"; Values="true"}
```
**Ausgabe:**
```
CidrBlock : 172.31.0.0/16
DhcpOptionsId : dopt-12345678
InstanceTenancy : default
IsDefault : True
State : available
Tags : {}
VpcId : vpc-45678901
```
**Beispiel 3: In diesem Beispiel werden die VPCs beschrieben, die dem angegebenen Filter entsprechen (d. h. deren CIDR dem Wert „10.0.0“ entspricht). 0/16'und befinden sich im Status' verfügbar ').**
```
Get-EC2Vpc -Filter @{Name="cidr"; Values="10.0.0.0/16"},@{Name="state";Values="available"}
```
**Beispiel 2: In diesem Beispiel werden alle Ihre VPCs beschrieben.**
```
Get-EC2Vpc
```
+ Einzelheiten zur API finden Sie unter [DescribeVpcsAWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).*
**Tools für V5 PowerShell **
**Beispiel 1: In diesem Beispiel wird die angegebene VPC beschrieben.**
```
Get-EC2Vpc -VpcId vpc-12345678
```
**Ausgabe:**
```
CidrBlock : 10.0.0.0/16
DhcpOptionsId : dopt-1a2b3c4d
InstanceTenancy : default
IsDefault : False
State : available
Tags : {Name}
VpcId : vpc-12345678
```
**Beispiel 2: In diesem Beispiel wird die Standard-VPC beschrieben (es kann nur eine pro Region geben). Wenn Ihr Konto EC2-Classic in dieser Region unterstützt, gibt es keine Standard-VPC.**
```
Get-EC2Vpc -Filter @{Name="isDefault"; Values="true"}
```
**Ausgabe:**
```
CidrBlock : 172.31.0.0/16
DhcpOptionsId : dopt-12345678
InstanceTenancy : default
IsDefault : True
State : available
Tags : {}
VpcId : vpc-45678901
```
**Beispiel 3: In diesem Beispiel werden die VPCs beschrieben, die dem angegebenen Filter entsprechen (d. h. deren CIDR dem Wert „10.0.0“ entspricht). 0/16'und befinden sich im Status' verfügbar ').**
```
Get-EC2Vpc -Filter @{Name="cidr"; Values="10.0.0.0/16"},@{Name="state";Values="available"}
```
**Beispiel 2: In diesem Beispiel werden alle Ihre VPCs beschrieben.**
```
Get-EC2Vpc
```
+ Einzelheiten zur API finden Sie unter [DescribeVpcsAWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
------
#### [ Python ]
**SDK für Python (Boto3)**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS-Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/ec2#code-examples) einrichten und ausführen.
```
class AutoScalingWrapper:
"""
Encapsulates Amazon EC2 Auto Scaling and EC2 management actions.
"""
def __init__(
self,
resource_prefix: str,
inst_type: str,
ami_param: str,
autoscaling_client: boto3.client,
ec2_client: boto3.client,
ssm_client: boto3.client,
iam_client: boto3.client,
):
"""
Initializes the AutoScaler class with the necessary parameters.
:param resource_prefix: The prefix for naming AWS resources that are created by this class.
:param inst_type: The type of EC2 instance to create, such as t3.micro.
:param ami_param: The Systems Manager parameter used to look up the AMI that is created.
:param autoscaling_client: A Boto3 EC2 Auto Scaling client.
:param ec2_client: A Boto3 EC2 client.
:param ssm_client: A Boto3 Systems Manager client.
:param iam_client: A Boto3 IAM client.
"""
self.inst_type = inst_type
self.ami_param = ami_param
self.autoscaling_client = autoscaling_client
self.ec2_client = ec2_client
self.ssm_client = ssm_client
self.iam_client = iam_client
sts_client = boto3.client("sts")
self.account_id = sts_client.get_caller_identity()["Account"]
self.key_pair_name = f"{resource_prefix}-key-pair"
self.launch_template_name = f"{resource_prefix}-template-"
self.group_name = f"{resource_prefix}-group"
# Happy path
self.instance_policy_name = f"{resource_prefix}-pol"
self.instance_role_name = f"{resource_prefix}-role"
self.instance_profile_name = f"{resource_prefix}-prof"
# Failure mode
self.bad_creds_policy_name = f"{resource_prefix}-bc-pol"
self.bad_creds_role_name = f"{resource_prefix}-bc-role"
self.bad_creds_profile_name = f"{resource_prefix}-bc-prof"
def get_default_vpc(self) -> Dict[str, Any]:
"""
Gets the default VPC for the account.
:return: Data about the default VPC.
"""
try:
response = self.ec2_client.describe_vpcs(
Filters=[{"Name": "is-default", "Values": ["true"]}]
)
except ClientError as err:
error_code = err.response["Error"]["Code"]
log.error("Failed to retrieve the default VPC.")
if error_code == "UnauthorizedOperation":
log.error(
"You do not have the necessary permissions to describe VPCs. "
"Ensure that your AWS IAM user or role has the correct permissions."
)
elif error_code == "InvalidParameterValue":
log.error(
"One or more parameters are invalid. Check the request parameters."
)
log.error(f"Full error:\n\t{err}")
else:
if "Vpcs" in response and response["Vpcs"]:
log.info(f"Retrieved default VPC: {response['Vpcs'][0]['VpcId']}")
return response["Vpcs"][0]
else:
pass
```
+ Einzelheiten zur API finden Sie [DescribeVpcs](https://docs.aws.amazon.com/goto/boto3/ec2-2016-11-15/DescribeVpcs)in *AWSSDK for Python (Boto3) API* Reference.
------
Eine vollständige Liste der AWS SDK-Entwicklerhandbücher und Codebeispiele finden Sie unter. [EC2 Amazon-Ressourcen mithilfe eines AWS SDK erstellen](sdk-general-information-section.md) Dieses Thema enthält auch Informationen zu den ersten Schritten und Details zu früheren SDK-Versionen.